🗺️ Navigation

• 📖 Overview
• ⚙️ Setup
• 🚀 Features
• 🌟 Support

⚙️ Setup

Choose the installation method that fits your workflow. Both methods require a Jules API Key.

[!IMPORTANT] Visit jules.google.com/settings/api to generate your credentials before proceeding.

The fastest way to get started. Copy the block below and paste it into your AI assistant (Antigravity, Cursor, or Claude).

Read https://raw.githubusercontent.com/TheRealAshik/jules-mcp/refs/heads/main/docs/AGENT_INSTALL.md and do as per the instructions.

If you prefer to configure the server yourself, follow these steps:

1. Locate your config file:

   • Antigravity: ~/.gemini/antigravity/mcp_config.json
   • Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json
   • Cursor: Settings > Features > MCP > Add New Server

2. Add the following snippet:

{
  "mcpServers": {
    "jules-mcp": {
      "command": "npx",
      "args": ["-y", "@realashik/jules-mcp"],
      "env": {
        "JULES_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

📖 Overview

Jules MCP is a Model Context Protocol (MCP) server designed to supercharge AI coding agents to control Jules. While standard AI agents are limited to linear task execution, Jules MCP introduces Staged Orchestration—enabling a "Commander" agent to deploy multiple specialized sub-agents (Maestros, Crews, Freelancers) to handle distinct parts of a project simultaneously or in sequence.

Built on top of the official @google/jules-sdk, it provides the bridge between your IDE and a distributed team of AI workers with advanced features like real-time streaming, session management, and intelligent caching.

[!TIP] Use IDE agents to analyse and assign tasks to Jules to get best output from this MCP.

[!NOTE] v1.0.4+ now uses the official Google Jules SDK for improved reliability, streaming support, and better error handling.

🚀 Features

• 🎭 Multi-Role Orchestration: Spawn MAESTRO (Architect), CREW (Implementer), FREELANCER (Specialist), or EVALUATOR (Quality Control).
• 📝 Staged Workflows: Automatically manage git branches, code generation, and merging in a single, safe flow.
• 🧠 Global Shared Memory: Cross-session memory allows workers to pass variables and context like biological collaborators.
• 🛡️ Quality Enforcement: Built-in review cycles ensure code meets security and performance standards before merging.
• ⚡ Zero Configuration: Instantly usable via npx with automatic environment discovery.
• 🌊 Real-time Streaming: Stream live activity updates from Jules sessions using the official SDK.
• 🔄 Session Management: Simplified session lifecycle with automatic polling and state management.

🌟 Support

If Jules MCP helps you build faster, please consider:

• ⭐️ Starring the GitHub Repository
• 👤 Following TheRealAshik for updates.

Developed with ❤️ by TheRealAshik