Jules

You run an MCP server that lets your AI coding assistant create, manage, and interact with Jules coding sessions through a Streamable HTTP transport. It connects your agent to Jules API capabilities like session management, source listing, and activity monitoring, so you can automate coding tasks while keeping control over plans before actions are taken.

How to use

Set up the Jules MCP server and connect your MCP client to start creating coding sessions, listing your connected GitHub sources, and sending messages to Jules agents. You can request additional information from Jules, review execution plans, and monitor real-time session activity. Use the jules_list_sources tool to verify your connected sources and then create a session with a prompt to begin autonomous coding.

How to install

Prerequisites: Node.js v18 or newer, npm, and a Jules API key.

# 1) Clone the project
git clone https://github.com/yourusername/jules-mcp-server.git
cd jules-mcp-server

# 2) Install dependencies
npm install

Additional setup and configuration

Configure environment variables to enable authentication and network settings. Create a .env file from the example and provide your Jules API key.

JULES_API_KEY=your_api_key_here
PORT=3323
HOST=127.0.0.1
ALLOWED_ORIGINS=null,http://localhost

Starting the server

Run the development server now to begin serving MCP connections. The server exposes an MCP endpoint at the following URL.

npm run dev

Connecting an MCP client

Add an MCP configuration that points your client to the local Jules MCP server endpoint. Use the Streamable HTTP transport and the MCP URL shown below.

{
  "mcpServers": {
    "jules": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:3323/mcp"
    }
  }
}

Your first prompt and session usage

List your connected sources to verify visibility, then create a new Jules session by supplying a prompt and the source path. You can require plan approval to review changes before Jules executes them.

List my Jules sources

Tools overview

The server exposes a set of tools for session management, plan approval, and monitoring. All tools validate inputs with runtime schemas to ensure safe, predictable requests to Jules.

Available tools include creating sessions, listing sessions, sending messages to an active Jules agent, approving plans, listing sources, and listing session activities.

Available tools

jules_create_session

Create a new Jules coding session by providing a prompt and source path as inputs.

jules_list_sessions

List all Jules coding sessions associated with your account.

jules_send_message

Send a message to an active Jules agent within a session.

jules_approve_plan

Approve a session's execution plan before actions are performed.

jules_list_sources

List your connected GitHub sources available to Jules.

jules_list_activities

List activities for a specific Jules session.