Skip to main content
Glama

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

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

License

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GreyC/jules-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server