Devin MCP Server

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)

| Tool | Description | |------|-------------| | create_session | Create a new Devin session | | get_session | Get session details by ID | | list_sessions | List sessions | | send_session_message | Send a message to an active session | | update_session_tags | Update session tags | | upload_attachment | Upload a file for use in sessions | | list_secrets | List org secret metadata | | create_secret | Create a secret | | delete_secret | Delete a secret | | list_knowledge | List knowledge items | | create_knowledge | Create a knowledge item | | delete_knowledge | Delete a knowledge item | | list_playbooks | List playbooks | | create_playbook | Create a playbook | | delete_playbook | Delete a playbook |

v2 Tools (Enterprise Admin)

| Tool | Description | |------|-------------| | enterprise_list_organizations | List organisations | | enterprise_create_organization | Create an organisation | | enterprise_list_members | List members | | enterprise_invite_members | Invite members | | enterprise_session_insights | Get session insights | | enterprise_consumption_cycles | Get billing cycles | | enterprise_audit_logs | Get audit logs | | enterprise_metrics | Get analytics metrics | | enterprise_list_api_keys | List service API keys | | enterprise_list_groups | List IdP groups | | enterprise_list_playbooks | List enterprise playbooks | | enterprise_set_git_permission | Set git repo permissions |

v3 Tools (RBAC / Service Users)

| Tool | Description | |------|-------------| | v3_get_self | Get authenticated service user info | | v3_list_organizations | List organisations | | v3_get_organization | Get organisation details | | v3_list_sessions | List org sessions | | v3_get_session | Get session details | | v3_create_session | Create a session | | v3_send_session_message | Message a session | | v3_terminate_session | Terminate a session | | v3_archive_session | Archive a session | | v3_list_enterprise_service_users | List enterprise service users | | v3_create_enterprise_service_user | Create enterprise service user | | v3_list_org_service_users | List org service users | | v3_audit_logs | Get audit logs | | v3_consumption_cycles | Get billing cycles | | v3_consumption_daily | Get daily consumption | | v3_list_enterprise_notes | List enterprise knowledge | | v3_list_org_notes | List org knowledge | | v3_list_enterprise_playbooks | List enterprise playbooks | | v3_list_org_playbooks | List org playbooks | | v3_list_org_secrets | List org secrets | | v3_list_git_connections | List git connections | | v3_list_git_permissions | List git permissions | | v3_list_enterprise_users | List enterprise users | | v3_list_org_users | List org users | | v3_list_enterprise_idp_groups | List IdP groups | | v3_list_roles | List roles | | v3_usage_metrics | Get usage metrics | | v3_queue_status | Get queue status | | v3_list_org_tags | List org session tags |

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

| API Version | Token Prefix | Type | |-------------|-------------|------| | v1 | apk_user_ or apk_ | Personal or Service API Key | | v2 | apk_user_ | Enterprise Admin Personal Key | | v3 | cog_ | Service User Credential |