PluginBench
MCP Server
Active
MIT

Email Inbox API + Sending by Sendmux MCP Server

io.github.Sendmux/sendmux-mcp

AI-powered email inbox and sending with attachments, search, live events, and webhooks.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Draft, send, or triage messages and email from inside your agent.
  • Pipe notifications from a build or alert into your team channel automatically.
  • Summarize a busy channel thread into the handful of points that matter.

How to compare servers like this

Channel coverage:
Check the specific app (email, chat, notifications) and whether it reads as well as writes.
Scope of access:
Messages are sensitive; review what the tool can see before connecting an account.
Rate behavior:
Bulk-sending tools should respect provider limits — avoid anything that floods.
Maintenance signal:
APIs in this space change often; recent updates are a strong signal.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the Email Inbox API + Sending by Sendmux MCP server?

The Sendmux MCP server provides AI agents with email inbox management and sending capabilities through the Sendmux Mailbox and Sending APIs. It enables reading, searching, and monitoring emails with attachment support, as well as composing and sending messages with files.

Sendmux MCP exposes email operations for AI agents: receive and search messages, handle attachments with download URLs, stream live mailbox events, and send emails with files. Use it to build AI workflows that interact with email inboxes, automate message handling, or integrate email into agent-driven applications.

How to install Email Inbox API + Sending by Sendmux

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • SENDMUX_MCP_SURFACES
    required

    Tool surfaces to run locally.

  • SENDMUX_MAILBOX_API_KEY
    required
    secret

    Mailbox API key for Mailbox API and Sending API tools.

  • SENDMUX_MANAGEMENT_API_KEY
    required
    secret

    Root API key for Management API tools.

  • SENDMUX_SENDING_API_KEY
    secret

    Optional send-capable smx_mbx_ key or owner-approved smx_agent_ token for Sending API tools when it differs from the Mailbox API key.

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "sendmux-mcp": {
      "command": "uvx",
      "args": [
        "sendmux-mcp"
      ],
      "env": {
        "SENDMUX_MCP_SURFACES": "<YOUR_SENDMUX_MCP_SURFACES>",
        "SENDMUX_MAILBOX_API_KEY": "<YOUR_SENDMUX_MAILBOX_API_KEY>",
        "SENDMUX_MANAGEMENT_API_KEY": "<YOUR_SENDMUX_MANAGEMENT_API_KEY>",
        "SENDMUX_SENDING_API_KEY": "<YOUR_SENDMUX_SENDING_API_KEY>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • mailbox_get_message — Retrieve a single message from the mailbox with metadata and attachment information.
  • mailbox_list_messages — List and search messages in the mailbox with filtering and pagination.
  • mailbox_get_attachment — Fetch attachment metadata and download URLs for message attachments.
  • mailbox_upload_attachment — Upload files to attach to outbound messages.
  • mailbox_send_message — Send an email message with optional attachments from the mailbox.
  • mailbox_wait_for_message — Wait for and receive new messages with a bounded timeout.
  • mailbox_stream_events — Stream live mailbox events in real-time (new messages, reads, etc.).
  • sending_send_email — Send an email via the Sending API with support for attachments and templates.

Use cases

  • Monitor and respond to incoming emails in real-time using live mailbox events and agent workflows.
  • Search and retrieve specific messages from an inbox to extract information or trigger actions.
  • Send automated emails with attachments (PDFs, reports, files) from AI agent workflows.
  • Build email-based notification systems that attach files and respond to inbox changes.
  • Integrate email as a communication channel for multi-step AI agent processes.

Email Inbox API + Sending by Sendmux MCP server FAQ

What is the Sendmux MCP server?

It's an MCP server that gives AI agents access to email inbox operations (read, search, stream events) and sending capabilities (compose, send with attachments) via the Sendmux Mailbox and Sending APIs.

Is Sendmux free?

Sendmux offers both free and paid tiers. Check sendmux.ai/docs for pricing and free-tier limits.

How do I install it in Claude or Cursor?

Install via PyPI: `pip install sendmux-mcp`, then configure with your Sendmux API key (smx_mbx_* or smx_agent_*). Alternatively, connect to the hosted MCP endpoint at https://mcp.sendmux.ai/mcp using OAuth.

What authentication is required?

You need a Sendmux API key: use `smx_mbx_*` keys for mailbox and sending, or owner-approved `smx_agent_*` tokens. The hosted MCP endpoint uses OAuth and does not require manual key setup.

Can I send attachments?

Yes. Use `mailbox_upload_attachment` to upload files, then include them in `mailbox_send_message` or `sending_send_email`. The Sending API supports up to 10 attachments and 25 MB request body.

Does it support live email events?

Yes. Use `mailbox_wait_for_message` for bounded waits or `mailbox_stream_events` to stream live mailbox events (new messages, reads, etc.) in real-time.

README (reference)

Source of truth, from the repository.

Sendmux SDKs

npm version PyPI version Go Reference crates.io version CI npm downloads Licence: MIT

Official SDK, CLI, and MCP workspace for Sendmux.

Packages

EcosystemPackageSurfaceAPI key or authInstallSource
npm@sendmux/coreShared TypeScript helpersn/anpm install @sendmux/corepackages/ts/core
npm@sendmux/sendingSending APIsmx_mbx_* or owner-approved smx_agent_*npm install @sendmux/sendingpackages/ts/sending
npm@sendmux/mailboxMailbox APIsmx_mbx_* or smx_agent_*npm install @sendmux/mailboxpackages/ts/mailbox
npm@sendmux/managementManagement APIsmx_root_*npm install @sendmux/managementpackages/ts/management
npm@sendmux/sdkTypeScript umbrella packagesurface-specificnpm install @sendmux/sdkpackages/ts/sdk
npm@sendmux/clisendmux CLIcommand/profile-specificnpm install -g @sendmux/clipackages/ts/cli
npm@sendmux/ai-sdkVercel AI SDK tools (agent inbox + sending)send + receive smx_mbx_* or smx_agent_*npm install @sendmux/ai-sdkpackages/ts/ai-sdk
Homebrewsendmuxsendmux CLIcommand/profile-specificbrew install sendmux/tap/sendmuxSendmux/homebrew-tap
PyPIsendmux-coreShared Python helpersn/apip install sendmux-corepackages/python/core
PyPIsendmux-sendingSending APIsmx_mbx_* or owner-approved smx_agent_*pip install sendmux-sendingpackages/python/sending
PyPIsendmux-mailboxMailbox APIsmx_mbx_* or smx_agent_*pip install sendmux-mailboxpackages/python/mailbox
PyPIsendmux-managementManagement APIsmx_root_*pip install sendmux-managementpackages/python/management
PyPIsendmux-sdkPython umbrella packagesurface-specificpip install sendmux-sdkpackages/python/sdk
PyPIsendmux-mcpLocal MCP plus hosted MCP and A2A serversOAuth for hosted; surface-specific keys for localpip install sendmux-mcppackages/python/mcp
PyPIlangchain-sendmuxLangChain toolkit (agent inbox + sending)send + receive smx_mbx_* or smx_agent_*pip install langchain-sendmuxpackages/python/langchain
Gosendmux.ai/go/coreShared Go helpersn/ago get sendmux.ai/go@v1.0.0go/core
Gosendmux.ai/go/sendingSending APIsmx_mbx_* or owner-approved smx_agent_*go get sendmux.ai/go@v1.0.0go/sending
Gosendmux.ai/go/mailboxMailbox APIsmx_mbx_* or smx_agent_*go get sendmux.ai/go@v1.0.0go/mailbox
Gosendmux.ai/go/managementManagement APIsmx_root_*go get sendmux.ai/go@v1.0.0go/management
Gosendmux.ai/go/sdkGo umbrella packagesurface-specificgo get sendmux.ai/go@v1.0.0go/sdk
crates.iosendmuxRust umbrella cratesurface-specificcargo add sendmuxrust
Packagistsendmux/coreShared PHP helpersn/acomposer require sendmux/core:^1.0packages/php/core
Packagistsendmux/sendingSending APIsmx_mbx_* or owner-approved smx_agent_*composer require sendmux/sending:^1.0packages/php/sending
Packagistsendmux/mailboxMailbox APIsmx_mbx_* or smx_agent_*composer require sendmux/mailbox:^1.0packages/php/mailbox
Packagistsendmux/managementManagement APIsmx_root_*composer require sendmux/management:^1.0packages/php/management
Packagistsendmux/sdkPHP umbrella packagesurface-specificcomposer require sendmux/sdk:^1.0packages/php/sdk
RubyGemssendmux-coreShared Ruby helpersn/agem install sendmux-corepackages/ruby/core
RubyGemssendmux-sendingSending APIsmx_mbx_* or owner-approved smx_agent_*gem install sendmux-sendingpackages/ruby/sending
RubyGemssendmux-mailboxMailbox APIsmx_mbx_* or smx_agent_*gem install sendmux-mailboxpackages/ruby/mailbox
RubyGemssendmux-managementManagement APIsmx_root_*gem install sendmux-managementpackages/ruby/management
RubyGemssendmux-sdkRuby umbrella packagesurface-specificgem install sendmux-sdkpackages/ruby/sdk

Quick start

Install only the package for the surface you need.

npm install @sendmux/sending
pip install sendmux-sending
go get sendmux.ai/go@v1.0.0
cargo add sendmux
composer require sendmux/sending:^1.0
gem install sendmux-sending

Use send-capable smx_mbx_* keys or owner-approved Sending-resource smx_agent_* tokens for Sending clients. Use smx_mbx_* keys or scoped smx_agent_* tokens for Mailbox clients. Use root smx_root_* keys for Management clients. Agent tokens remain limited by server-side scopes; pre-claim self-registered agent tokens do not include email.send.

For command-line access, install the CLI:

brew install sendmux/tap/sendmux
npm install -g @sendmux/cli
sendmux --help

For MCP clients, install sendmux-mcp or connect to the hosted MCP endpoint:

pip install sendmux-mcp
sendmux-mcp-mailbox --help

The hosted MCP endpoint is https://mcp.sendmux.ai/mcp. Local MCP commands support stdio and HTTP transports; hosted MCP uses OAuth and does not require manual API keys or custom OAuth endpoints.

For A2A 1.0 clients, discover the hosted HTTP+JSON service from https://a2a.sendmux.ai/.well-known/agent-card.json. It exposes the same curated mailbox, management, and sending operations with an OAuth grant bound specifically to https://a2a.sendmux.ai/a2a/v1.

For AI-agent frameworks, first-party tool wrappers are available:

npm install @sendmux/ai-sdk ai zod   # Vercel AI SDK: sendmux({ apiKey }) returns a ToolSet
pip install langchain-sendmux        # LangChain: SendmuxToolkit(api_key=...).get_tools()

Both wrap the generated Sending and Mailbox clients, so the OpenAPI spec stays the single source of truth.

Attachments And Live Mailbox Events

Mailbox attachment metadata now includes a short-lived download_url. Fetch that URL promptly with a plain HTTP client; it does not require an Authorization header, but it expires after a short TTL. If a download URL expires, re-fetch the message or attachment metadata to receive a fresh URL.

For outbound files, avoid manually placing base64 in prompts or source strings. Use the zero-context path for your lane:

  • CLI: sendmux mailbox:send-message --attach ./report.pdf or sendmux sending:send --attach ./report.pdf.
  • TypeScript: use @sendmux/mailbox/node sendMailboxMessageWithFiles(...) or @sendmux/sending/node sendEmailWithFiles(...).
  • Python: use sendmux_mailbox.send_mailbox_message_with_files(...) or sendmux_sending.send_email_with_files(...).
  • MCP: local stdio can use mailbox_upload_attachment with file_path; hosted and shell-capable agents can mint a presigned upload URL, PUT bytes to it without an API key, then send with the returned blob_id.

Mailbox direct uploads, presigned uploads, CLI --attach, and mailbox SDK file helpers share the mailbox attachment cap: currently 7,500,000 bytes per attachment. Sending API attachment helpers encode files into the send request body; the generated Sending API limit is max 10 attachments and a 25 MB request body.

Small generated attachments can still use inline base64 where the API schema supports them. MCP inline base64 is capped at 32 KiB decoded; the cheaper alternatives are file_path, presigned upload, CLI --attach, and SDK file helpers.

Live mailbox events are available through idiomatic lanes:

  • TypeScript: streamMailboxEvents(...) returns an async iterator over typed mailbox realtime events.
  • Python: iter_mailbox_events(...) yields typed MailboxRealtimeEvent models from the generated mailbox client.
  • CLI: sendmux mailbox:stream-events --follow prints one JSON event per line until the stream closes or the process is interrupted.
  • MCP: use mailbox_wait_for_message for bounded waits inside agent tool calls, then mailbox_get_attachment to renew attachment metadata and fetch download_url.

Repository structure

PathPurpose
packages/tsTypeScript SDK packages and the sendmux CLI.
packages/pythonPython SDK packages and the sendmux-mcp package.
goGo module sendmux.ai/go and subpackages.
rustRust crate published as sendmux on crates.io.
packages/phpPHP package sources used for Packagist packages and public split repositories.
packages/rubyRubyGem package sources.
codegenGenerator configuration and templates.
scriptsGeneration, verification, publishing, and release helper scripts.
docsSurface-coverage and live E2E audit artefacts.
.github/workflowsCI, canary, live E2E, and release workflows.

Versioning and support

SDK packages track the Sendmux public API contracts. Patch versions can differ between packages when a fix only affects one ecosystem or runtime.

Generated clients are built from committed OpenAPI snapshots. Any API contract change must update the snapshots and generated output in the same change.

For help, open a GitHub issue with the package name, version, command or import path, and the request ID from any API error response.

Contributing

Open pull requests against this repository. Keep generated output, source snapshots, and verification artefacts together in the same change.

Security issues should be reported through GitHub Security Advisories.

Licence

This repository is available under the MIT licence.

Related MCP servers

Thrd MCP: agent email tools for events/threads, safe send/reply, usage, trust and security.

View repository →
ZAZammad MCP logo

Zammad ticket, article, and Knowledge Base operations via CLI and MCP server for AI agents

25
Go
View repository →

Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.

0
TypeScript
MIT
View repository →

ChatGenius tools: Instagram, Facebook, WhatsApp and SMS inbox, contacts, bookings, flows, posts.

Pay-per-use web extract, token prices, and wallet balances via x402 USDC micropayments.

View repository →

SomaCheck returns proposition-specific Aligned or Unaligned plus model confidence.