devin-api-mcp

MCP servers providing full Devin API coverage — manage sessions, knowledge, playbooks, secrets, schedules, and attachments programmatically from any MCP client — plus a documentation-only DeepWiki proxy.

The hosted Devin MCP server bundles documentation lookups together with session/platform management in one server. This package splits those concerns: the devin-api-* servers give you everything except docs, and the deepwiki proxy gives you docs only (so it can't be confused for a delegation tool).

Servers

This package exposes three MCP servers:

• 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.

• deepwiki — a read-only proxy to the upstream Devin MCP (https://mcp.devin.ai/mcp, personal key) that re-exposes ONLY ask_question, read_wiki_structure, and read_wiki_contents. Private repos work (it authenticates with your personal key), but session/platform tools are filtered out — there is no way to create or manage a Devin session through it. Set the upstream with DEEPWIKI_UPSTREAM_URL (default https://mcp.devin.ai/mcp) and optionally DEVIN_ORG_ID.

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

Setup

1. Get your API keys

Follow the Devin API authentication guide to generate your keys:

Server	Environment Variable	Key Prefix	Where to Get It
v1	DEVIN_PERSONAL_API_KEY	apk_user_	Devin account settings
v3	DEVIN_SERVICE_API_KEY	cog_	Devin organization settings

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

Tool	Description
create_session	Start a new Devin session with a prompt (supports playbooks, tags, knowledge, secrets, structured output)
list_sessions	List recent sessions with status and metadata (filterable by tags, user)
get_session	Get session details including messages and structured output
send_message	Send a follow-up message to a running session
terminate_session	Stop a running session
update_session_tags	Replace tags on a session

Knowledge

Tool	Description
list_knowledge	List all knowledge entries and folders
create_knowledge	Create a knowledge entry (teaches Devin domain-specific info)
update_knowledge	Update an existing knowledge entry
delete_knowledge	Permanently delete a knowledge entry

Playbooks

Tool	Description
list_playbooks	List available playbooks (titles and IDs)
get_playbook	Get full playbook details
create_playbook	Create a new team playbook
update_playbook	Update an existing playbook
delete_playbook	Delete a team playbook

Secrets

Tool	Description
list_secrets	List secret metadata (values are never returned)
create_secret	Create a new encrypted secret
delete_secret	Permanently delete a secret

Attachments

Tool	Description
upload_attachment	Upload a file for use in sessions (returns URL for ATTACHMENT:"<url>" format)

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)

Tool	Description
list_schedules	List scheduled Devin sessions
get_schedule	Get schedule details
create_schedule	Create a recurring scheduled session
update_schedule	Update an existing schedule
delete_schedule	Delete a schedule

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