Jules MCP Server

Jules MCP Server

MCP (Model Context Protocol) server for Google Jules, the asynchronous AI coding agent. This server enables LLMs to create Jules sessions with automatic pull request creation.

Features

• Auto-PR Creation: Sessions automatically create pull requests when complete
• Issue Integration: Create sessions directly from GitHub issues
• Session Management: List and monitor your Jules sessions

Installation

npm install -g @anthropic/jules-mcp

Or run directly with npx:

npx @anthropic/jules-mcp

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | JULES_API_KEY | Yes | Jules API key from Google AI Studio | | GITHUB_TOKEN | No | GitHub token for fetching issue details (optional but recommended) |

Claude Code

Add to ~/.config/ccs/mcp.toml:

[servers.jules]
command = "npx @anthropic/jules-mcp"

[servers.jules.env]
JULES_API_KEY = "env://JULES_API_KEY"
GITHUB_TOKEN = "env://GITHUB_TOKEN"

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "jules": {
      "command": "npx",
      "args": ["@anthropic/jules-mcp"],
      "env": {
        "JULES_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

create_session

Create a new Jules coding session.

Parameters:

• repo (required): GitHub repository in owner/repo format
• prompt (required): Task description for Jules
• auto_pr (optional, default: true): Automatically create a PR when done
• starting_branch (optional): Branch to start from
• title (optional): Session title

Example: ``json { "repo": "myorg/myrepo", "prompt": "Add input validation to the login form", "auto_pr": true } ``

create_session_from_issue

Create a session directly from a GitHub issue.

Parameters:

• repo (required): GitHub repository in owner/repo format
• issue_number (required): GitHub issue number
• additional_context (optional): Extra instructions

Example: ``json { "repo": "myorg/myrepo", "issue_number": 42 } ``

list_sessions

List your Jules sessions.

Parameters:

• limit (optional, default: 10): Maximum sessions to return

get_session

Get details of a specific session.

Parameters:

• session_id (required): The session ID

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
JULES_API_KEY=your-key node dist/index.js

License

MIT