devin-api-mcp

Two MCP servers providing full Devin API coverage — manage sessions, knowledge, playbooks, secrets, schedules, and attachments programmatically from any MCP client.

The existing Devin MCP server only supports documentation/wiki lookups and asking questions about repositories. This package gives you everything else.

Two-Server Architecture

This package exposes two MCP servers mirroring Devin's API versioning:

• devin-api-v1 — Legacy v1 API (19 tools). Uses a personal API key (apk_user_ prefix).
• devin-api-v3 — v3 Organization API (33 tools). Uses a service user key (cog_ prefix). Auto-discovers your org_id at startup via /v3/self.

Setup

1. Get your API keys

Follow the Devin API authentication guide to generate your keys:

Note: The v1 server also accepts DEVIN_API_KEY as a fallback for backward compatibility.

2. Register with Claude Code

# v1 (personal API — sessions, knowledge, playbooks, secrets, attachments)
claude mcp add -s user -e DEVIN_PERSONAL_API_KEY=<your-personal-key> -- devin-api-v1 npx -y -p @jsklan/devin-api-mcp devin-api-v1

# v3 (organization API — adds schedules, more session tools)
claude mcp add -s user -e DEVIN_SERVICE_API_KEY=<your-service-key> -- devin-api-v3 npx -y -p @jsklan/devin-api-mcp devin-api-v3

Alternative: Install as a Claude Code plugin

1. Run /plugin in Claude Code
2. Go to Marketplaces → + Add Marketplace
3. Enter jsklan/devin-api-mcp
4. Go to Discover, find devin-api, and install it

Make sure DEVIN_PERSONAL_API_KEY and/or DEVIN_SERVICE_API_KEY are set in your environment. The plugin will start the MCP servers automatically and stay up to date.

3. Register with other MCP clients

Add to your MCP config (e.g. mcp.json):

{
  "mcpServers": {
    "devin-api-v1": {
      "command": "npx",
      "args": ["-y", "-p", "@jsklan/devin-api-mcp", "devin-api-v1"],
      "env": {
        "DEVIN_PERSONAL_API_KEY": "your_personal_key_here"
      }
    },
    "devin-api-v3": {
      "command": "npx",
      "args": ["-y", "-p", "@jsklan/devin-api-mcp", "devin-api-v3"],
      "env": {
        "DEVIN_SERVICE_API_KEY": "your_service_key_here"
      }
    }
  }
}

Tools

v1 Server (19 tools)

Sessions

Knowledge

Playbooks

Secrets

Attachments

v3 Server (33 tools)

The v3 server includes all the same categories as v1 (with expanded session tools) plus schedules and an additional attachment tool. All operations are scoped to your organization.

Sessions (14 tools)

Expanded session management including listing by status, bulk operations, and session events.

Knowledge (4 tools)

Same as v1 — list, create, update, delete.

Playbooks (5 tools)

Same as v1 — list, get, create, update, delete.

Secrets (3 tools)

Same as v1 — list, create, delete.

Schedules (5 tools)

Attachments (2 tools)

Upload and manage files for use in sessions.

API Coverage

• v1 server wraps the Devin REST API v1 — 19 tools across 5 categories.
• v3 server wraps the Devin REST API v3 — 33 tools across 6 categories. Enterprise (/v3/enterprise/...) and beta (/v3beta1/...) endpoints are intentionally excluded.

Written in TypeScript with Zod schema validation.

License

MIT