Devin MCP Server

A Python MCP (Model Context Protocol) server that wraps all three Devin API versions (v1, v2, v3beta1) with multi-organisation support.

Features

• All API versions: v1 (org-scoped), v2 (enterprise admin), v3beta1 (RBAC/service users)
• Multi-org: Route requests to different organisations via the org parameter
• Config-driven: JSON config file for PAT tokens (excluded from source control)
• Conditional registration: Only registers tools for API versions you have tokens for

Setup

1. Install dependencies

cd devin-mcp
pip install -e .
# or
pip install -r requirements.txt

2. Create config file

Copy the example and fill in your tokens:

cp config.example.json config.json

Edit config.json:

{
  "default_org": "my-org",
  "organizations": {
    "my-org": {
      "description": "Primary organisation",
      "tokens": {
        "v1": "apk_user_YOUR_V1_TOKEN",
        "v2": "apk_user_YOUR_V2_ENTERPRISE_ADMIN_TOKEN",
        "v3": "cog_YOUR_V3_SERVICE_USER_TOKEN"
      }
    },
    "other-org": {
      "description": "Secondary organisation",
      "tokens": {
        "v1": "apk_YOUR_OTHER_ORG_TOKEN"
      }
    }
  }
}

Note: config.json is in .gitignore and will not be committed.

You can also set DEVIN_MCP_CONFIG=/path/to/config.json to use a config file from any location.

3. Configure your MCP client

#### VS Code / Copilot

Add to your MCP settings (settings.json or .vscode/mcp.json):

{
  "mcpServers": {
    "devin": {
      "command": "python",
      "args": ["-m", "devin_mcp.server"],
      "cwd": "/path/to/devin-mcp/src"
    }
  }
}

#### Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "devin": {
      "command": "python",
      "args": ["-m", "devin_mcp.server"],
      "cwd": "/path/to/devin-mcp/src"
    }
  }
}

Or using the installed entry point:

{
  "mcpServers": {
    "devin": {
      "command": "devin-mcp"
    }
  }
}

Available Tools

v1 Tools (Org-Scoped)

v2 Tools (Enterprise Admin)

v3 Tools (RBAC / Service Users)

Multi-Organisation Usage

Every tool accepts an optional org parameter. When omitted, the default_org from config is used.

"Create a Devin session in my-org to review PR #42"
→ Uses default org token

"List sessions in other-org"
→ Routes to other-org's token

Token Types