apigee-mcp

An MCP server that exposes Apigee X / GCP Management API operations as tools for Claude (and any other MCP-compatible LLM client).

Prerequisites

Authenticate with Application Default Credentials once:

gcloud auth application-default login

Related MCP server: gcloud MCP Cloud Run

Installation

cd apigee-mcp
python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env and set APIGEE_ORG=<your-gcp-project-id>

Running the server

python server.py

The server communicates over stdio (standard MCP transport). You will not see any output on startup unless APIGEE_ORG is missing, in which case it exits with a descriptive error.

Claude Desktop configuration

Add the block below to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "apigee": {
      "command": "/absolute/path/to/apigee-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/apigee-mcp/server.py"],
      "env": {
        "APIGEE_ORG": "my-gcp-project-id"
      }
    }
  }
}

Replace the paths and project ID with your own values. Restart Claude Desktop after saving the file.

VS Code configuration

Create .vscode/mcp.json in your workspace (or add to your user settings):

{
  "servers": {
    "apigee": {
      "type": "stdio",
      "command": "/absolute/path/to/apigee-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/apigee-mcp/server.py"],
      "env": {
        "APIGEE_ORG": "my-gcp-project-id"
      }
    }
  }
}

Available tools

Example questions to ask Claude

• "List all environments in my Apigee org."

• "Show me the error rate for the payments-proxy in prod over the last 24 hours."

• "Which revision of orders-api is deployed to staging?"

• "What API products bundle the inventory-proxy?"

• "List all developers who registered in 2024."

• "Which apps does developer alice@example.com have, and what products do they use?"

Using a service account instead of ADC

1. Create a service account in GCP with the Apigee Organization Admin role (or a more restrictive read-only role if preferred).

2. Download the JSON key file.

3. Set the environment variable before running the server:

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/sa-key.json
python server.py

google.auth.default() automatically picks up GOOGLE_APPLICATION_CREDENTIALS, so no code changes are needed.

Quick token test (no ADC setup)

export APIGEE_ACCESS_TOKEN=$(gcloud auth print-access-token)
export APIGEE_ORG=my-gcp-project-id
python server.py

When APIGEE_ACCESS_TOKEN is set it takes priority over ADC. The token expires after ~1 hour; restart the server or unset the variable to fall back to ADC.