Skip to main content
Glama
Google Jules MCP Server

Google Jules MCP Server

by Godzilla675

Google Jules MCP Server

An MCP (Model Context Protocol) server that provides access to the Google Jules API - Google's AI-powered coding agent for automating software development tasks.

Features

This MCP server exposes all Jules API capabilities:

Sources

  • jules_list_sources - List all connected GitHub repositories

  • jules_get_source - Get details of a specific source

Sessions

  • jules_list_sessions - List all coding sessions

  • jules_get_session - Get session details including state and outputs

  • jules_create_session - Create a new coding task for Jules

  • jules_approve_plan - Approve a plan in a session requiring approval

  • jules_send_message - Send a message to Jules within a session

Activities

  • jules_list_activities - List all activities within a session

  • jules_get_activity - Get details of a specific activity

Related MCP server: Jules MCP Server

Installation

npx google-jules-mcp

Global installation

npm install -g google-jules-mcp
google-jules-mcp

Configuration

Environment Variable

Set your Google Jules API key:

export GOOGLE_JULES_API_KEY=your_api_key_here

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "google-jules": {
      "command": "npx",
      "args": ["google-jules-mcp"],
      "env": {
        "GOOGLE_JULES_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage Examples

List available repositories

Use jules_list_sources to see all connected GitHub repositories.

Create a coding session

Use jules_create_session with:
- prompt: "Fix the authentication bug in login.js"
- source: "sources/github/myorg/myrepo"
- startingBranch: "main"
- automationMode: "AUTO_CREATE_PR"

Monitor session progress

Use jules_list_activities with the sessionId to see what Jules is doing.

Interact with Jules

Use jules_send_message to ask Jules questions or provide feedback during a session.

API Key

To get your Jules API key:

  1. Go to Jules Settings

  2. Create a new API key

  3. Keep it secure - don't share or commit it to public repositories

Prerequisites

  • Node.js 18.0.0 or higher

  • A Google Jules API key

  • GitHub repositories connected to Jules (via the Jules web app)

License

MIT

Available Tools

9 tools
jules_approve_planB

Approve a plan in a session that requires plan approval. This allows Jules to proceed with executing the plan.

Inputs: sessionId (required).

jules_create_sessionA

Create a new Jules session to start a coding task. Jules will work on the task autonomously, optionally creating a PR when done.

Inputs: prompt (required), source (required), startingBranch (required), title, +2 more.

jules_get_activityA

Get details of a specific activity within a session, including artifacts like code changes, bash outputs, or media.

Inputs: sessionId (required), activityId (required).

jules_get_sessionA

Get details of a specific session including its state, source context, outputs, and any pull requests created.

Inputs: sessionId (required).

jules_get_sourceA

Get details of a specific source by its name. Returns source information including GitHub repo owner, name, branches, and privacy status.

Inputs: name (required).

jules_list_activitiesC

List all activities within a session. Activities include plan generation, progress updates, messages, and completion status.

Inputs: sessionId (required), pageSize, pageToken.

jules_list_sessionsA

List all sessions. Sessions are continuous units of work within a specific context. Returns session details including state, outputs, and pull requests.

Inputs: pageSize, pageToken.

jules_list_sourcesA

List all available sources (GitHub repositories) connected to Jules. Returns a list of sources with their names and GitHub repo details.

Inputs: pageSize, pageToken.

jules_send_messageA

Send a message to Jules within an active session. Use this to provide feedback, ask questions, or request changes.

Inputs: sessionId (required), prompt (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a distinct purpose: session operations, activity tracking, source management, and messaging. There is no overlap, and descriptions clearly differentiate them.

    Naming Consistency5/5

    All tools follow a consistent 'jules_verb_noun' pattern in snake_case, making it easy to predict and understand the tool's function from its name.

    Tool Count5/5

    With 9 tools, the server is well-scoped for its domain. The number is within the ideal range and each tool serves a clear role without redundancy.

    Completeness4/5

    The tool set covers session lifecycle, activity details, and source management. Minor gaps like delete operations exist but do not hinder core workflows.

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      A
      quality
      Not graded
      maintenance
      Enables automation of Google Jules AI coding assistant through task creation, code review automation, repository management, and AI-powered development workflows. Supports multiple session modes including cloud deployment with persistent authentication.
      13
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI coding assistants to the Jules API for autonomous coding sessions. Enables creating and managing coding sessions, GitHub integration, plan approval workflows, and real-time activity tracking directly from your IDE.
      10 npm
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Google's Jules coding agent API for autonomous coding tasks, allowing users to delegate bug fixes, refactoring, testing, and feature development with scheduling capabilities and human-in-the-loop approval workflows.
      6
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables LLM applications to interact with Google's Jules AI coding assistant to manage repositories, coding sessions, and pull requests. It allows users to programmatically create tasks, approve plans, and communicate with the assistant during active coding sessions.
      9
      -