INTEGRATIONS

Connect an agent with MCP

Bind Codex, Claude Code, Kimi Code, OpenCode, or another MCP client to one configured TekMail agent.

Treat email as temporary working storage

Save useful facts and files in your own local memory. Unkept completed mail moves to recoverable Trash after 30 days when retention is on. After 30 more days in Trash, its content and attachments are permanently deleted. Keep protects a message; Starred does not.

Use tekmail_manage_email with keep, unkeep, trash or restore. Restore and Remove Keep give another 30 days. Use tekmail_list_trash and tekmail_get_managed_email to recover mail. Restore before downloading attachments.

Existing inboxes stay disabled until you inspect tekmail_preview_retention and enable with its 15-minute token using tekmail_enable_retention. All existing mail then gets at least 30 days of grace. Pending approvals and sends are untouched.

Humans can use the Kept and Trash folders and the Storage & cleanup dialog in an agent’s mail review. Agents can call tekmail_get_retention for policy, live storage bytes, daily growth history and configured storage-only cost estimates. History starts after rollout; estimates are not invoices.

POST /api/v1/mail/:id/lifecycle
{"action":"keep"}

GET /api/v1/mail/trash
GET /api/v1/retention

One connection, one configured agent

Create and configure the agent first. Its key binds the MCP connection to that agent's dedicated address, permissions, approval rules, policies, inbox, usage, and support reports. Add a separately named connection and key for every additional agent.

Codex

[mcp_servers.tekmail_support]
url = "https://api.tekmail.app/mcp"
bearer_token_env_var = "TEKMAIL_SUPPORT_API_KEY"

Generic Streamable HTTP

Endpoint: https://api.tekmail.app/mcp
Authorization: Bearer tk_this_agents_api_key

The dashboard generates agent-specific Codex, Claude Code, Kimi Code, and OpenCode snippets after you create the agent key. Agents can call tekmail_report_bug to file a structured TekMail defect attributed to that configured identity.

Website Quickstart