emailcommunicationmcpapisendmux
Email inbox API MCP server enabling AI agents to receive, search, and send mail via Sendmux hosted or local MCP.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent ā or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag ā we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ā¾
Client Config & Setup
Choose your client or environment
Target File:
š” Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Receive and read emails programmatically
Search emails within inboxes
Send emails via Sendmux API
Integrate email handling into AI agents
Manage mailboxes through hosted or local MCP
Key features
Supports Sendmux hosted and local MCP deployments
Provides mailbox API for email retrieval and search
Supports sending emails via Sendmux sending API
Uses OAuth for hosted MCP authentication
Supports API key authentication for local MCP
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Sendmux Sdk.
Extracted Tool Capabilities
Supports Sendmux hosted and local MCP deployments
Provides mailbox API for email retrieval and search
Supports sending emails via Sendmux sending API
Uses OAuth for hosted MCP authentication
Supports API key authentication for local MCP
Documentation Overview
Sendmux SDKs
Official SDK, CLI, and MCP workspace for Sendmux.
- Product documentation: sendmux.ai/docs
- Management API reference: sendmux.ai/docs/api/introduction
- Mailbox API reference: sendmux.ai/docs/mailbox-api/introduction
- Sending API reference: sendmux.ai/docs/sending-api/introduction
- MCP guide: sendmux.ai/docs/ai-integrations/mcp
Packages
| Ecosystem | Package | Surface | API-key / hosted auth | Install | Source |
|---|---|---|---|---|---|
| npm | @sendmux/core | Shared TypeScript helpers | n/a | npm install @sendmux/core | packages/ts/core |
| npm | @sendmux/sending | Sending API | smx_mbx_* or owner-approved smx_agent_* | npm install @sendmux/sending | packages/ts/sending |
| npm | @sendmux/mailbox | Mailbox API | smx_mbx_* or smx_agent_* | npm install @sendmux/mailbox | packages/ts/mailbox |
| npm | @sendmux/management | Management API | smx_root_* | npm install @sendmux/management | packages/ts/management |
| npm | @sendmux/sdk | TypeScript umbrella package | surface-specific | npm install @sendmux/sdk | packages/ts/sdk |
| npm | @sendmux/cli | sendmux CLI | command/profile-specific | npm install -g @sendmux/cli | packages/ts/cli |
| npm | @sendmux/ai-sdk | Vercel AI SDK tools (agent inbox + sending) | send + receive smx_mbx_* or smx_agent_* | npm install @sendmux/ai-sdk | packages/ts/ai-sdk |
| Homebrew | sendmux | sendmux CLI | command/profile-specific | brew install sendmux/tap/sendmux | Sendmux/homebrew-tap |
| PyPI | sendmux-core | Shared Python helpers | n/a | pip install sendmux-core | packages/python/core |
| PyPI | sendmux-sending | Sending API | smx_mbx_* or owner-approved smx_agent_* | pip install sendmux-sending | packages/python/sending |
| PyPI | sendmux-mailbox | Mailbox API | smx_mbx_* or smx_agent_* | pip install sendmux-mailbox | packages/python/mailbox |
| PyPI | sendmux-management | Management API | smx_root_* | pip install sendmux-management | packages/python/management |
| PyPI | sendmux-sdk | Python umbrella package | surface-specific | pip install sendmux-sdk | packages/python/sdk |
| PyPI | sendmux-mcp | Local MCP plus hosted MCP and A2A servers | OAuth for hosted; surface-specific keys for local | pip install sendmux-mcp | packages/python/mcp |
| PyPI | langchain-sendmux | LangChain toolkit (agent inbox + sending) | REST OAuth or send + receive smx_mbx_* / smx_agent_* | pip install langchain-sendmux | packages/python/langchain |
| Go | sendmux.ai/go/core | Shared Go helpers | n/a | go get sendmux.ai/go@v1.6.0 | go/core |
| Go | sendmux.ai/go/sending | Sending API | smx_mbx_* or owner-approved smx_agent_* | go get sendmux.ai/go@v1.6.0 | go/sending |
| Go | sendmux.ai/go/mailbox | Mailbox API | smx_mbx_* or smx_agent_* | go get sendmux.ai/go@v1.6.0 | go/mailbox |
| Go | sendmux.ai/go/management | Management API | smx_root_* | go get sendmux.ai/go@v1.6.0 | go/management |
| Go | sendmux.ai/go/sdk | Go umbrella package | surface-specific | go get sendmux.ai/go@v1.6.0 | go/sdk |
| crates.io | sendmux | Rust umbrella crate | surface-specific | cargo add sendmux | rust |
| Packagist | sendmux/core | Shared PHP helpers | n/a | composer require sendmux/core:^2.1 | packages/php/core |
| Packagist | sendmux/sending | Sending API | smx_mbx_* or owner-approved smx_agent_* | composer require sendmux/sending:^2.1 | packages/php/sending |
| Packagist | sendmux/mailbox | Mailbox API | smx_mbx_* or smx_agent_* | composer require sendmux/mailbox:^2.1 | packages/php/mailbox |
| Packagist | sendmux/management | Management API | smx_root_* | composer require sendmux/management:^2.1 | packages/php/management |
| Packagist | sendmux/sdk | PHP umbrella package | surface-specific | composer require sendmux/sdk:^2.1 | packages/php/sdk |
| RubyGems | sendmux-core | Shared Ruby helpers | n/a | gem install sendmux-core | packages/ruby/core |
| RubyGems | sendmux-sending | Sending API | smx_mbx_* or owner-approved smx_agent_* | gem install sendmux-sending | packages/ruby/sending |
| RubyGems | sendmux-mailbox | Mailbox API | smx_mbx_* or smx_agent_* | gem install sendmux-mailbox | packages/ruby/mailbox |
| RubyGems | sendmux-management | Management API | smx_root_* | gem install sendmux-management | packages/ruby/management |
| RubyGems | sendmux-sdk | Ruby umbrella package | surface-specific | gem install sendmux-sdk | packages/ruby/sdk |
Quick start
Install only the package for the surface you need.
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.
OAuth authentication
TypeScript, Python, Go, PHP, Ruby, and Rust surface clients accept a bare REST OAuth access token or a provider that resolves one before each request. Use the explicit token API below; API-key configuration continues to validate key prefixes.
| Client | Access-token configuration |
|---|---|
| TypeScript | accessToken: token or accessToken: () => token; async providers are supported. |
| Vercel AI SDK | sendmux({ accessToken: token }) or an async token provider; grant mailbox.read and email.send for one mailbox. |
| Python | access_token=token or a callable. |
| LangChain | SendmuxToolkit(access_token=token) or a callable; grant mailbox.read and email.send for one mailbox. |
| Go | NewWithAccessToken(token) or NewWithTokenProvider(provider); providers receive the request context. |
| PHP | ClientFactory::createMetaApiWithAccessToken($token) or a callable; each API factory has a WithAccessToken variant. |
| Ruby | access_token: token or a callable. |
| Rust | new_with_access_token(token) or new_with_token_provider(provider); providers return a future. |
Choose one credential source. Your application owns secure storage and refresh coordination. Request resource=https://sendmux.ai/api; each API still checks its required scopes and granted surface. The CLI manages browser login and token refresh with sendmux auth:login; use sendmux auth:logout to revoke its connection.
Command-line access
For command-line access, install the CLI:
Agent registration does not require an existing account or API key. It creates a local profile with a durable, revocable credential for reading and receiving mail. To send, invite the owner with sendmux agent:invite-owner owner@example.com --profile my-agent; after the owner accepts and approves sending, Sending API commands exchange and cache a one-hour delegated token automatically.
For MCP clients, install sendmux-mcp or connect to the hosted MCP endpoint:
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:
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks ā not a rating.
GitHub stars
73
Stargazers on the source repository.
Last commit
9d ago
Most recent push to the default branch.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet ā be the first to share how this listing worked for you.
Frequently Asked Questions about Sendmux Sdk
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/sendmux-sendmux-sdk)HTML Embed
<a href="https://allmcps.com/mcp/sendmux-sendmux-sdk"><img src="https://allmcps.com/api/badge/sendmux-sendmux-sdk?style=directory" alt="Sendmux Sdk on AllMCPs" /></a>