Devin MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Connect your Devin account

   Get your API key and create a connected account

   Register your Devin API key with Scalekit so it stores it securely and injects it into every request. Devin uses API key authentication — there is no redirect URI or OAuth flow.

   1. Get your Devin API key

      • Sign in to Devin and go to Settings → Devin API.
      • Click the API keys (legacy) tab.
      • Under Personal API key, click View key to reveal your key, or expand the dropdown to regenerate it.

      

      Keep your key private

      Devin API keys are tied to your account and have full access. Store the key in a secrets manager and never hard-code it in your source code. Use Devin Secrets to give Devin access to third-party credentials instead.

   2. Create a connection in Scalekit

      • In Scalekit dashboard, go to AgentKit → Connections → Create Connection. Find Devin MCP and click Create.
      • Note the Connection name — you will use this as connection_name in your code (e.g., devinmcp).
      • Click Save.

   3. Add a connected account

      Connected accounts link a specific user identifier in your system to their Devin API key. Add them via the dashboard for testing, or via the Scalekit API in production.

      Via dashboard (for testing)

      • Open the connection you created and click the Connected Accounts tab → Add account.
      • Fill in:
        • Your User’s ID — a unique identifier for this user in your system (e.g., user_123)
        • API Key — the Devin API key from step 1
      • Click Create Account.

      Via API (for production)

      Node.js

      import { Scalekit } from '@scalekit-sdk/node';
      
      const scalekit = new Scalekit(
        process.env.SCALEKIT_ENV_URL,
        process.env.SCALEKIT_CLIENT_ID,
        process.env.SCALEKIT_CLIENT_SECRET,
      );
      
      // Never hard-code credentials — read from secure storage or user input
      const devinApiKey = getUserDevinApiKey(); // retrieve from your secure store
      
      await scalekit.actions.upsertConnectedAccount({
        connectionName: 'devinmcp',
        identifier: 'user_123',
        credentials: {
          username: devinApiKey,
        },
      });

      Python

      import os
      from scalekit import ScalekitClient
      
      scalekit_client = ScalekitClient(
          env_url=os.environ["SCALEKIT_ENV_URL"],
          client_id=os.environ["SCALEKIT_CLIENT_ID"],
          client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
      )
      
      # Never hard-code credentials — read from secure storage or user input
      devin_api_key = get_user_devin_api_key()  # retrieve from your secure store
      
      scalekit_client.actions.upsert_connected_account(
          connection_name="devinmcp",
          identifier="user_123",
          credentials={"username": devin_api_key},
      )

      Production usage tip

      In production, call upsert_connected_account (Python) / upsertConnectedAccount (Node.js) when a user connects their Devin account — for example, on an integrations settings page in your app.

4. Make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'devinmcp'
   const identifier = 'user_123'
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'devinmcp_devin_session_search',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "devinmcp"
   identifier = "user_123"
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="devinmcp_devin_session_search",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Read wiki structure, wiki contents — Get a list of documentation topics for a GitHub repository
• List integrations, available repos — List all native integrations and MCP servers for the organization with status and settings
• Wiki generate — Generate a codebase wiki for a repository and wait for it to complete
• Search devin session — Search and filter Devin sessions by date, tags, playbook, schedule, or user
• Interact devin session — Interact with a Devin session — get status, send a message, sleep, or terminate
• Gather devin session — Wait for multiple Devin sessions to reach a settled state before returning

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

devinmcp_ask_question # Ask any question about a GitHub repository and get an AI-powered, context-grounded response. 2 params ▾

Ask any question about a GitHub repository and get an AI-powered, context-grounded response.

Name Type Required Description

question string required No description.

repoName string required No description.

devinmcp_devin_knowledge_manage # Manage Devin knowledge notes and suggestions — list, get, create, or update entries. 18 params ▾

Manage Devin knowledge notes and suggestions — list, get, create, or update entries.

Name Type Required Description

action string required No description.

after string optional No description.

body string optional No description.

content string optional No description.

event_id string optional No description.

event_ids string optional No description.

first string optional No description.

folder_path string optional No description.

limit string optional No description.

name string optional No description.

note_id string optional No description.

offset string optional No description.

pinned_repo string optional No description.

query string optional No description.

search string optional No description.

since_days string optional No description.

status string optional No description.

trigger string optional No description.

devinmcp_devin_playbook_manage # Manage Devin playbooks — list, get, create, or update playbook entries. 8 params ▾

Manage Devin playbooks — list, get, create, or update playbook entries.

Name Type Required Description

action string required No description.

after string optional No description.

body string optional No description.

content string optional No description.

first string optional No description.

macro string optional No description.

playbook_id string optional No description.

title string optional No description.

devinmcp_devin_schedule_manage # Manage scheduled Devin sessions — list, get, create, update, or delete schedules. 15 params ▾

Manage scheduled Devin sessions — list, get, create, update, or delete schedules.

Name Type Required Description

action string required No description.

agent string optional No description.

bypass_approval string optional No description.

enabled string optional No description.

frequency string optional No description.

limit string optional No description.

name string optional No description.

notify_on string optional No description.

offset string optional No description.

playbook_id string optional No description.

prompt string optional No description.

schedule_id string optional No description.

schedule_type string optional No description.

scheduled_at string optional No description.

target_devin_id string optional No description.

devinmcp_devin_session_create # Create one or more child Devin sessions via the REST API. 5 params ▾

Create one or more child Devin sessions via the REST API.

Name Type Required Description

sessions array required No description.

devin_mode string optional No description.

platform string optional No description.

repos string optional No description.

structured_output_schema string optional No description.

devinmcp_devin_session_events # Inspect events within a Devin session — list summaries, fetch full details, or search. 14 params ▾

Inspect events within a Devin session — list summaries, fetch full details, or search.

Name Type Required Description

action string required No description.

session_id string required No description.

after string optional No description.

categories string optional No description.

created_after string optional No description.

created_before string optional No description.

direction string optional No description.

event_ids string optional No description.

event_types string optional No description.

first string optional No description.

limit string optional No description.

max_content_length string optional No description.

offset string optional No description.

query string optional No description.

devinmcp_devin_session_gather # Wait for multiple Devin sessions to reach a settled state before returning. 3 params ▾

Wait for multiple Devin sessions to reach a settled state before returning.

Name Type Required Description

session_ids array required No description.

poll_interval_seconds integer optional No description.

timeout_seconds integer optional No description.

devinmcp_devin_session_interact # Interact with a Devin session — get status, send a message, sleep, or terminate. 7 params ▾

Interact with a Devin session — get status, send a message, sleep, or terminate.

Name Type Required Description

action string required No description.

session_id string required No description.

after string optional No description.

archive_on_terminate boolean optional No description.

first string optional No description.

message string optional No description.

tags string optional No description.

devinmcp_devin_session_search # Search and filter Devin sessions by date, tags, playbook, schedule, or user. 12 params ▾

Search and filter Devin sessions by date, tags, playbook, schedule, or user.

Name Type Required Description

after string optional No description.

created_after string optional No description.

created_before string optional No description.

first string optional No description.

origins string optional No description.

playbook_id string optional No description.

schedule_id string optional No description.

session_ids string optional No description.

tags string optional No description.

updated_after string optional No description.

updated_before string optional No description.

user_ids string optional No description.

devinmcp_generate_wiki # Generate a codebase wiki for a repository and wait for it to complete. 1 param ▾

Generate a codebase wiki for a repository and wait for it to complete.

Name Type Required Description

repoName string required No description.

devinmcp_list_available_repos # List all repositories available to query with your Devin account. 0 params ▾

List all repositories available to query with your Devin account.

devinmcp_list_integrations # List all native integrations and MCP servers for the organization with status and settings. 1 param ▾

List all native integrations and MCP servers for the organization with status and settings.

Name Type Required Description

filter string optional No description.

devinmcp_read_wiki_contents # View documentation content for a GitHub repository. 1 param ▾

View documentation content for a GitHub repository.

Name Type Required Description

repoName string required No description.

devinmcp_read_wiki_structure # Get a list of documentation topics for a GitHub repository. 1 param ▾

Get a list of documentation topics for a GitHub repository.

Name Type Required Description

repoName string required No description.