OAUTH 2.0
COMMUNICATION
Agentmail MCP gives agents their own inboxes: send, receive, and manage email threads and attachments with vaulted credentials.
from langchain_mcp_adapters.client import MultiServerMCPClient
from scalekit import ScalekitClient
client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="agentmailmcp")
mcp = MultiServerMCPClient({
"agentmailmcp": {
"url": "https://mcp.scalekit.com/agentmailmcp",
"headers": {"Authorization": "Bearer " + token}
}
})
tools = await mcp.get_tools()import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";
const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "agentmailmcp" });
const openai = new OpenAI();
// Connect to MCP at https://mcp.scalekit.com/agentmailmcp
// Pass: Authorization: Bearer + tokenimport Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";
const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "agentmailmcp" });
const anthropic = new Anthropic();
// Connect to MCP at https://mcp.scalekit.com/agentmailmcp
// Pass: Authorization: Bearer + tokenfrom google.adk.agents import LlmAgent
from scalekit import ScalekitClient
client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="agentmailmcp")
# Connect to MCP at https://mcp.scalekit.com/agentmailmcp
# Pass: Authorization: Bearer + token
.svg)
.svg.png){kind=icon}
// shared token
audit → bot_service_account
// scalekit
audit → user_abc ✓
Does the agent access Agentmail as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.
Where is the Agentmail OAuth token stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.
Can I limit what the agent is allowed to do in Agentmail?
Yes. Pass a tool name filter to listScopedTools so the messaging agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Agentmail.
What happens when a user revokes Agentmail access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.
Can one agent's inbox read another agent's mail?
No. Inboxes, drafts, and threads are scoped to the authorizing user's Agentmail account with per-tenant vault isolation. Each agent inbox stays its own mailbox.
