🗺️ Navigation

📖 Overview
🚀 Features
⚙️ Setup
🛠 Development
📂 Knowledge Base
🌟 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.

🤖 Method 1: Agent-Driven Install (Recommended)

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/main/docs/SELF_INSTALL.md and do as per the instructions. I have my JULES_API_KEY ready.

👤 Method 2: Manual Self-Install

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

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
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 high-performance Model Context Protocol (MCP) server designed to supercharge AI coding assistants. 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 Google Jules API and the MCP SDK, it provides the bridge between your IDE and a distributed team of AI workers.

[!TIP] Jules MCP works best when allowed to manage its own branches. Ensure your JULES_API_KEY has repository write access for the best experience.

🚀 Features

Click to expand features list

🎭 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.

🛠 Development

# 1. Clone the repository
git clone https://github.com/TheRealAshik/jules-mcp.git

# 2. Install dependencies
npm install

# 3. Build & Run
npm run build
npm start

📂 Knowledge Base

🔧 SKILLS.md - Comprehensive tool mapping documentation.
🤖 SELF_INSTALL.md - Logic for AI agent self-installation.

🌟 Support

If Jules MCP helps you build faster, please consider:

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

Developed with ❤️ by TheRealAshik

Jules MCP Server