Jules Node MCP

A Model Context Protocol (MCP) server for interacting with the Google Jules API.

Installation

1. Clone this repository.

2. Install dependencies:

   npm install

3. Build the project (optional, you can run directly with tsx):

   npm run build

   (Note: You'll need to add a build script to package.json if you want to build to JS: "build": "tsc")

Configuration

You need to set up Google Authentication. The server uses Application Default Credentials (ADC). You can set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of your service account key file, or use gcloud auth application-default login.

Usage with MCP Client (e.g., Claude Desktop)

To use this server with an MCP client, add the following configuration to your client's settings file (e.g., claude_desktop_config.json).

JSON Example

{
  "mcpServers": {
    "jules-node-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/path/to/jules-node-mcp/src/index.ts"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json"
      }
    }
  }
}

Replace /path/to/jules-node-mcp with the actual absolute path to this directory, and /path/to/your/credentials.json with your Google Cloud credentials file path.

Tools

list-sessions

Lists all Jules sessions.

• Input:
  • pageSize (optional): Number of sessions to return (1-100).
  • pageToken (optional): Token for the next page.
• Output: JSON object containing a list of sessions and a nextPageToken.