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:

{
  "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:

{
  "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