Agentmail 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. Authorize and 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 = 'agentmailmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Agentmail MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'agentmailmcp_list_inboxes',
     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 = "agentmailmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Agentmail MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="agentmailmcp_list_inboxes",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update message, draft — Update a message’s labels by adding or removing label values
• Send message, draft — Send a new email message from an inbox to one or more recipients
• Message reply to, forward — Reply to a specific message, optionally replying to all recipients
• List threads, inboxes, drafts — List message threads in an inbox with optional label filtering and pagination
• Get thread, inbox, draft — Retrieve a message thread by ID, including all messages in the conversation
• Delete inbox, draft — Permanently delete an inbox and all its associated messages

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.

agentmailmcp_create_draft#Create a draft email in an inbox, optionally scheduling it to send at a future time.12 params▾

Create a draft email in an inbox, optionally scheduling it to send at a future time.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

attachmentsarrayoptionalAttachments

bccarrayoptionalBCC recipients

ccarrayoptionalCC recipients

htmlstringoptionalHTML body

inReplyTostringoptionalMessage ID this draft is replying to

labelsarrayoptionalLabels

replyToarrayoptionalReply-to addresses

sendAtstringoptionalISO 8601 datetime to schedule sending (e.g. 2026-04-01T09:00:00Z)

subjectstringoptionalSubject

textstringoptionalPlain text body

toarrayoptionalRecipients

agentmailmcp_create_inbox#Create a new inbox with a given username and domain for sending and receiving email.3 params▾

Create a new inbox with a given username and domain for sending and receiving email.

NameTypeRequiredDescription

displayNamestringoptionalDisplay name

domainstringoptionalDomain

usernamestringoptionalUsername

agentmailmcp_delete_draft#Delete a draft by ID. Also cancels any scheduled send for that draft.2 params▾

Delete a draft by ID. Also cancels any scheduled send for that draft.

NameTypeRequiredDescription

draftIdstringrequiredID of draft

inboxIdstringrequiredID of inbox

agentmailmcp_delete_inbox#Permanently delete an inbox and all its associated messages.1 param▾

Permanently delete an inbox and all its associated messages.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

agentmailmcp_forward_message#Forward an existing message to one or more recipients, optionally adding extra content.10 params▾

Forward an existing message to one or more recipients, optionally adding extra content.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

messageIdstringrequiredID of message

toarrayrequiredRecipients

attachmentsarrayoptionalAttachments

bccarrayoptionalBCC recipients

ccarrayoptionalCC recipients

htmlstringoptionalHTML body

labelsarrayoptionalLabels

subjectstringoptionalSubject

textstringoptionalPlain text body

agentmailmcp_get_attachment#Retrieve a specific attachment from a message thread by attachment ID.3 params▾

Retrieve a specific attachment from a message thread by attachment ID.

NameTypeRequiredDescription

attachmentIdstringrequiredID of attachment

inboxIdstringrequiredID of inbox

threadIdstringrequiredID of thread

agentmailmcp_get_draft#Retrieve a draft by ID, including its content, status, and scheduled send time.2 params▾

Retrieve a draft by ID, including its content, status, and scheduled send time.

NameTypeRequiredDescription

draftIdstringrequiredID of draft

inboxIdstringrequiredID of inbox

agentmailmcp_get_inbox#Retrieve inbox details by ID, including its email address and configuration.1 param▾

Retrieve inbox details by ID, including its email address and configuration.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

agentmailmcp_get_thread#Retrieve a message thread by ID, including all messages in the conversation.2 params▾

Retrieve a message thread by ID, including all messages in the conversation.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

threadIdstringrequiredID of thread

agentmailmcp_list_drafts#List drafts in an inbox with optional label filtering and pagination.6 params▾

List drafts in an inbox with optional label filtering and pagination.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

afterstringoptionalFilter items after datetime

beforestringoptionalFilter items before datetime

labelsarrayoptionalLabels to filter items by

limitnumberoptionalMax number of items to return

pageTokenstringoptionalPage token for pagination

agentmailmcp_list_inboxes#List all inboxes with pagination support.2 params▾

List all inboxes with pagination support.

NameTypeRequiredDescription

limitnumberoptionalMax number of items to return

pageTokenstringoptionalPage token for pagination

agentmailmcp_list_threads#List message threads in an inbox with optional label filtering and pagination.6 params▾

List message threads in an inbox with optional label filtering and pagination.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

afterstringoptionalFilter items after datetime

beforestringoptionalFilter items before datetime

labelsarrayoptionalLabels to filter items by

limitnumberoptionalMax number of items to return

pageTokenstringoptionalPage token for pagination

agentmailmcp_reply_to_message#Reply to a specific message, optionally replying to all recipients.7 params▾

Reply to a specific message, optionally replying to all recipients.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

messageIdstringrequiredID of message

attachmentsarrayoptionalAttachments

htmlstringoptionalHTML body

labelsarrayoptionalLabels

replyAllbooleanoptionalReply to all recipients

textstringoptionalPlain text body

agentmailmcp_send_draft#Send a draft immediately, converting it to a sent message.2 params▾

Send a draft immediately, converting it to a sent message.

NameTypeRequiredDescription

draftIdstringrequiredID of draft

inboxIdstringrequiredID of inbox

agentmailmcp_send_message#Send a new email message from an inbox to one or more recipients.9 params▾

Send a new email message from an inbox to one or more recipients.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

toarrayrequiredRecipients

attachmentsarrayoptionalAttachments

bccarrayoptionalBCC recipients

ccarrayoptionalCC recipients

htmlstringoptionalHTML body

labelsarrayoptionalLabels

subjectstringoptionalSubject

textstringoptionalPlain text body

agentmailmcp_update_draft#Update a draft's content, recipients, or scheduled send time.10 params▾

Update a draft's content, recipients, or scheduled send time.

NameTypeRequiredDescription

draftIdstringrequiredID of draft

inboxIdstringrequiredID of inbox

bccarrayoptionalBCC recipients

ccarrayoptionalCC recipients

htmlstringoptionalHTML body

replyToarrayoptionalReply-to addresses

sendAtstringoptionalISO 8601 datetime to reschedule sending

subjectstringoptionalSubject

textstringoptionalPlain text body

toarrayoptionalRecipients

agentmailmcp_update_message#Update a message's labels by adding or removing label values.4 params▾

Update a message's labels by adding or removing label values.

NameTypeRequiredDescription

inboxIdstringrequiredID of inbox

messageIdstringrequiredID of message

addLabelsarrayoptionalLabels to add

removeLabelsarrayoptionalLabels to remove