Jules

Provides programmatic access to Jules APIs for managing sources, sessions, messages, approvals, and PR creation.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "paladiamors-jules-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/jules-mcp",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "JULES_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run a dedicated MCP server that lets your MCP client interact with Jules, enabling session creation, messaging, plan approval, and activity tracking for coding tasks. This server exposes a programmable interface to manage Jules-powered sessions from your tooling and automations.

How to use

You interact with the Jules MCP server through an MCP client. Start by loading the server configuration into your client so it can connect to Jules and manage sessions. You can create sessions to describe the coding task, send messages during work, approve plans when required, and review activity history. If you prefer, you can also create a session designed to generate a pull request as part of the workflow. When a session completes, you can inspect the result outputs for URIs or artifacts like PR URLs.

How to install

Prerequisites you need before installation are: Python 3.10 or newer, a Jules API key, and GitHub repositories installed in Jules.

# Prereqs are assumed installed; proceed with the following steps
# Clone the repository for the Jules MCP server
git clone https://github.com/yourusername/jules-mcp.git
cd jules-mcp

# Install dependencies using uvx (recommended runtime)
uv sync

# Alternative: install dependencies with Python's package manager
# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install fastmcp httpx pydantic

Additional setup and notes

Set your Jules API key as an environment variable to authorize requests from the MCP server.

You can run the server standalone during development or embed it into your MCP client configuration for automated workflows.

Available tools

list_sources

List available GitHub repositories connected to Jules, with optional pagination controls.

get_source

Retrieve details about a specific source repository by its resource name.

list_sessions

List existing Jules sessions with optional filtering for active sessions and pagination.

get_session

Get detailed information about a particular session by name.

create_session

Create a new Jules session with a task prompt, repository source, and optional parameters like branch and title.

send_message

Send a follow-up message to an active session to clarify tasks or provide new input.

approve_plan

Approve Jules's plan for a session that is awaiting user approval.

list_activities

List the work history and actions taken within a session for auditing or progress tracking.

create_pull_request

Create a session that results in a pull request for the changes made during the session.