Jules MCP Server

Jules MCP Server

MCP server that exposes Google Jules capabilities using @google/jules-sdk. This unified implementation uses the SDK plus direct API calls where needed, while keeping SDK-backed caching, snapshots, and artifact handling. MCP tools may use either the SDK or the REST API, whichever is the best fit for the specific operation.

Setup

1. Install dependencies
2. Provide JULES_API_KEY via environment or ~/.jules/config.json
3. Build the server

npm install
npm run build

Run locally:

JULES_API_KEY=your_api_key node dist/cli.js

OpenCode Integration

This repo includes a project-level OpenCode config at .opencode/opencode.json. For global setup, add to ~/.config/opencode/opencode.json (update the command path to where you built this server):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jules": {
      "type": "local",
      "command": ["node", "/path/to/your/jules-mcp/dist/cli.js"],
      "environment": {
        "JULES_API_KEY": "your_api_key"
      }
    }
  }
}

Antigravity Integration

Example OpenCode plugin enablement snippet (merge into your config):

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": {
    "opencode-antigravity-auth": {
      "enabled": true
    }
  }
}

Tools

SDK Tools

Query example:

{
  "query": {
    "from": "sessions",
    "where": { "state": "failed" },
    "limit": 5
  }
}

Additional Tools (`jules_*`)

These tools are part of the same unified server and expose REST-style workflows plus convenience operations. They may use the SDK or the REST API under the hood, depending on which path is required for the operation. They return a structured ToolResult object:

{ success, message, data?, error?, suggestedNextSteps? }