jules-api-mcp

An MCP server for Jules — Google's AI coding agent. Manage Jules sessions from any MCP-compatible client: Claude, Gemini CLI, Cursor, Zed, VS Code, and more.

Tools

Tool	Description
list_sessions	List all Jules sessions
get_session	Get session details and current state
create_session	Create a new Jules session
approve_plan	Approve Jules's plan to proceed with execution
send_message	Send feedback or instructions to Jules
list_activities	Full activity timeline for a session
get_last_message	Jules's latest outbound message
get_pr_url	Get the PR URL from a completed session

Requirements

• Node.js 18+
• A Jules API key (JULES_API_KEY)

Installation

From source

git clone https://github.com/GreyC/jules-api-mcp
cd jules-api-mcp
npm install
npm run build

Configuration

Add to your MCP client config (e.g. ~/.claude/claude_desktop_config.json or ~/.gemini/settings.json):

{
  "mcpServers": {
    "jules": {
      "command": "node",
      "args": ["/path/to/jules-api-mcp/dist/index.js"],
      "env": {
        "JULES_API_KEY": "<your-key>"
      }
    }
  }
}

Usage Examples

List all sessions:

list_sessions()

Create a session with auto PR:

create_session(
  repo="owner/repo",
  prompt="Refactor the login function in auth.py to use async/await",
  automation_mode="AUTO_CREATE_PR"
)

Approve a plan:

approve_plan(session_id="<ID>")

Send feedback:

send_message(session_id="<ID>", message="Looks good, please create the PR.")

Session States

State	Meaning
IN_PROGRESS	Jules is actively working
AWAITING_PLAN_APPROVAL	Jules generated a plan, waiting for approval
AWAITING_USER_FEEDBACK	Jules has a question mid-execution
COMPLETED	Jules finished
FAILED	Unrecoverable error

Related

• jules-skill — Agent skill with workflow guidance, decision heuristics, and prompt templates for autonomous Jules management

License

MIT