{"_id":"@assistantmail/assistantmail-mcp","_rev":"7-c2eaef14c21a1218383a2117c4379185","name":"@assistantmail/assistantmail-mcp","dist-tags":{"latest":"1.3.3"},"versions":{"1.2.0":{"name":"@assistantmail/assistantmail-mcp","version":"1.2.0","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"author":{"name":"Crider Technologies"},"license":"MIT","_id":"@assistantmail/assistantmail-mcp@1.2.0","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"bin":{"assistantmail-mcp":"src/index.js"},"dist":{"shasum":"3cbf63e90c06cafc0258f3f3015441bc7f8c916b","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.2.0.tgz","fileCount":4,"integrity":"sha512-rkz48PtqtmhWimeWVPe1wv07QlJwETa3/SkrnwfpN6ot7ucdiLr5Vkq/k7FnMyy4ICbejFmO8qfbNvViuvbJew==","signatures":[{"sig":"MEYCIQDLR7M2GQ0ryEHmaUQKYU0ipRu/FW51T0Og4vKt1A0vsgIhAJajgCELrleQN+732dA4tqCe8LtyDMwJDqquhCPHFxfY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29304},"type":"module","engines":{"node":">=20"},"gitHead":"9c66f1a7cbbdb1c9cc49f9b1bb1c1b721f2ab4b6","scripts":{"build":"node --check src/index.js","start":"node src/index.js"},"_npmUser":{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"},"_npmVersion":"11.4.2","description":"AssistantMail MCP server","directories":{},"_nodeVersion":"22.15.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/assistantmail-mcp_1.2.0_1780263147397_0.7423837945401259","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@assistantmail/assistantmail-mcp","version":"1.2.1","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"author":{"name":"Crider Technologies"},"license":"MIT","_id":"@assistantmail/assistantmail-mcp@1.2.1","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"bin":{"assistantmail-mcp":"src/index.js"},"dist":{"shasum":"b4dbe028bb0b502923be051468b12cde10034d25","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.2.1.tgz","fileCount":4,"integrity":"sha512-ftZzihPHJZZ97pUAdmAcrzpyYMi8fAeAMN/2dWFqK8/67D7r4xvWKUCCnDjWfnOW0m9POVyvHudpPAjvuX/1jQ==","signatures":[{"sig":"MEUCIDb6I4CY/sZOT8MFrcGZ4GAZ+UH7zMWC1/4ezHbxFZt6AiEA4UKOAurrauWEbue0BllKLMkDhBmwRvm20L8rzsP5JQI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30182},"type":"module","engines":{"node":">=20"},"gitHead":"0c442e5425cdf859df446b40d12b5df2a9de5284","scripts":{"build":"node --check src/index.js","start":"node src/index.js"},"_npmUser":{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"},"_npmVersion":"11.4.2","description":"AssistantMail MCP server","directories":{},"_nodeVersion":"22.15.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/assistantmail-mcp_1.2.1_1780264225114_0.11602357983759282","host":"s3://npm-registry-packages-npm-production"}},"1.2.2":{"name":"@assistantmail/assistantmail-mcp","version":"1.2.2","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"author":{"name":"AssistantMail"},"license":"MIT","_id":"@assistantmail/assistantmail-mcp@1.2.2","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"homepage":"https://assistant-mail.ai","bugs":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"bin":{"assistantmail-mcp":"src/index.js"},"bug":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"dist":{"shasum":"3d9bca3aad520d7e088abbcfc43f7a7d6898850f","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.2.2.tgz","fileCount":4,"integrity":"sha512-UMOzkgb86+VIK1zQYgsCRiPm8anGhmAWBmx1hntMb1ei/d7eKD7oqt1uUiFAff35/89aew/OBCwuSzEMCNzAxA==","signatures":[{"sig":"MEYCIQDvv9mpFC3TA75/0hGXeUnCRYzxdhAgexYdpt8EyUX2BgIhAIum6+MCAr4wpz2uNuXodKuUlWU5N6DWNf4AKR+UBU5R","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@assistantmail%2fassistantmail-mcp@1.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":30825},"type":"module","engines":{"node":">=24"},"gitHead":"cbbe3cb344c862bc3fa9f22f903f55cd0c4f9a2e","scripts":{"lint":"node --check src/index.js","build":"node --check src/index.js","start":"node src/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:34c5d934-6d4b-4aaa-aace-2da8a02756e1"}},"repository":{"url":"git+https://github.com/AssistantMail/assistantmail-mcp.git","type":"git"},"_npmVersion":"11.13.0","description":"AssistantMail MCP server","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/assistantmail-mcp_1.2.2_1780282014843_0.3205710403420836","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@assistantmail/assistantmail-mcp","version":"1.3.0","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"author":{"name":"AssistantMail"},"license":"MIT","_id":"@assistantmail/assistantmail-mcp@1.3.0","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"homepage":"https://assistant-mail.ai","bugs":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"bin":{"assistantmail-mcp":"src/index.js"},"bug":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"dist":{"shasum":"eb91bca8dd163884ddf4448b3374dbfac6699e2f","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.3.0.tgz","fileCount":4,"integrity":"sha512-YXItQvx572kTHAnQ0Cw3tHN7xP/9f4ba0dPiWIJp1tOX5n3mbNnz1wosOAW8VvWFbyLUe9qMalaIqwnrXeKwyA==","signatures":[{"sig":"MEUCIQD5TKzbg6RfTQV5+TLA+Um2lYWmA3a4+39Z6FXw56qgbwIgZzbW3Decjxms5YhU5Wfevo1wabhzWCmwsG1mEie2ZHg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@assistantmail%2fassistantmail-mcp@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":32985},"type":"module","engines":{"node":">=24"},"gitHead":"4bb5fe397bc64a0bcd5967cd238e96dae74882da","scripts":{"lint":"node --check src/index.js","build":"node --check src/index.js","start":"node src/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:34c5d934-6d4b-4aaa-aace-2da8a02756e1"}},"repository":{"url":"git+https://github.com/AssistantMail/assistantmail-mcp.git","type":"git"},"_npmVersion":"11.13.0","description":"AssistantMail MCP server","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/assistantmail-mcp_1.3.0_1780799916016_0.6336215711024444","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@assistantmail/assistantmail-mcp","version":"1.3.1","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"author":{"name":"AssistantMail"},"license":"MIT","_id":"@assistantmail/assistantmail-mcp@1.3.1","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"homepage":"https://assistant-mail.ai","bugs":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"bin":{"assistantmail-mcp":"src/index.js"},"bug":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"dist":{"shasum":"638cf1ab5f0eac9b0354927546efbc3202c1363e","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.3.1.tgz","fileCount":4,"integrity":"sha512-a+E1PUXwMiwld6wlmHt9/fdlSZfgDidunBbRbS3SbwSA4UemH91QgpAX6ZIZA0vdVCqrrAwh+ecFFa7AxbF9Vw==","signatures":[{"sig":"MEUCIGgRiUk+2RfMYySnK+faMSt0mrJdSLoQnrVNTeJPRFKCAiEAwoQMX2mkflyeLXRUb9K9743uGodICOXYOvaPJpHezfM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQD5Gj6HuU3dGyYNB5k5Sm+Trq0dn2J2MpinTkeMUfYO8AIgc3pTeEDPYJ02AGFAHdK0GSdu/oPksK0a2FB/SDIHi54=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@assistantmail%2fassistantmail-mcp@1.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":33983},"type":"module","engines":{"node":">=24"},"gitHead":"73d5e34badcc296ea434e843eb30f4e892b715ab","mcpName":"io.github.AssistantMail/assistantmail-mcp","scripts":{"lint":"node --check src/index.js","build":"node --check src/index.js","start":"node src/index.js","mcp:check":"node scripts/check-mcp-registry.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:34c5d934-6d4b-4aaa-aace-2da8a02756e1"}},"repository":{"url":"git+https://github.com/AssistantMail/assistantmail-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"AssistantMail MCP server","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/assistantmail-mcp_1.3.1_1788396035647_0.779685476422513","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"@assistantmail/assistantmail-mcp","version":"1.3.2","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"author":{"name":"AssistantMail"},"license":"MIT","_id":"@assistantmail/assistantmail-mcp@1.3.2","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"homepage":"https://assistant-mail.ai","bugs":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"bin":{"assistantmail-mcp":"src/index.js"},"bug":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"dist":{"shasum":"31a404a763a8c86db0b2b6344f01151d4677ee2b","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.3.2.tgz","fileCount":4,"integrity":"sha512-2zEI4gCuYaxBYNbvisnsAW/Neb+3G5wi9uatnQgs2JOrV0xyYAfaq3bEa2Z1elQhRdk3mbcXdkTvHZ+VKt/wVA==","signatures":[{"sig":"MEQCIEhqBkYH4/+yrAQWktqkUoopdnXaLRgPEdL34d5uCPBHAiA75ZuXdgjrN4TrUvqV3cAQi0rqcT7x+8U/PrE9ztfOPw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCxOUbBkQZWWkozphzb5NiMYsk3njHiMQmSl4c4lmwrGAIgfwwmf+Hon/CPtAF3T1eckI+DtfGmvKRBtGCu/fhz1+0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@assistantmail%2fassistantmail-mcp@1.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":34104},"type":"module","engines":{"node":">=24"},"gitHead":"a10413ac4e4cbfd8badf47e9be06d1b4215a0097","mcpName":"io.github.AssistantMail/assistantmail-mcp","scripts":{"lint":"node --check src/index.js","build":"node --check src/index.js","start":"node src/index.js","mcp:check":"node scripts/check-mcp-registry.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:34c5d934-6d4b-4aaa-aace-2da8a02756e1"}},"repository":{"url":"git+https://github.com/AssistantMail/assistantmail-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"AssistantMail MCP server","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/assistantmail-mcp_1.3.2_1788978667982_0.5499839357490943","host":"s3://npm-registry-packages-npm-production"}},"1.3.3":{"_id":"@assistantmail/assistantmail-mcp@1.3.3","bin":{"assistantmail-mcp":"src/index.js"},"bug":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"bugs":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"dist":{"shasum":"6c2edc0f2822aab573e8c921bb9ac79d671a5582","tarball":"https://registry.npmjs.org/@assistantmail/assistantmail-mcp/-/assistantmail-mcp-1.3.3.tgz","fileCount":6,"integrity":"sha512-lLMkE+9QDW4MDkv00eFKTagheWqngpXcg0knsLk6qoKGTDIhYIokZWsd9+ILukgoDuRVtRGqPNzca4EEaB4P7w==","signatures":[{"sig":"MEUCIQDq+uRpHwlHY74vZM7NbwJgk1cYX12UR6kjuV3DQqJLrwIgO8f81pm5kSkQqDeCFChbevJihELzNm1TdFl1IgR3Krk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDHINxEAmLm+FGwD9ll9CdfKYefUZt8cNZKbKqsD/s7oAIhAKMrDXg3U+DLijWJL9C7Hg0ntxIDJ/jnyKIhaNFk/li1"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@assistantmail%2fassistantmail-mcp@1.3.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":35187},"name":"@assistantmail/assistantmail-mcp","type":"module","author":{"name":"AssistantMail"},"engines":{"node":">=24"},"gitHead":"16a3f921771d3e83d4d8a584594c6ed9ecb941c6","license":"MIT","mcpName":"io.github.AssistantMail/assistantmail-mcp","scripts":{"lint":"node --check src/index.js src/assistant-mail-request.js src/format-api-error.js","test":"node --test","build":"node --check src/index.js src/assistant-mail-request.js src/format-api-error.js","start":"node src/index.js","mcp:check":"node scripts/check-mcp-registry.mjs"},"version":"1.3.3","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:34c5d934-6d4b-4aaa-aace-2da8a02756e1"}},"homepage":"https://assistant-mail.ai","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"repository":{"url":"git+https://github.com/AssistantMail/assistantmail-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"AssistantMail MCP server","directories":{},"maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/assistantmail-mcp_1.3.3_1789049289945_0.2967251544995648"}}},"time":{"created":"2026-05-31T21:32:27.235Z","modified":"2026-09-10T14:08:10.407Z","1.2.0":"2026-05-31T21:32:27.544Z","1.2.1":"2026-05-31T21:50:25.239Z","1.2.2":"2026-06-01T02:46:54.967Z","1.3.0":"2026-06-07T02:38:36.158Z","1.3.1":"2026-09-03T00:40:35.764Z","1.3.2":"2026-09-09T18:31:08.119Z","1.3.3":"2026-09-10T14:08:10.043Z"},"bugs":{"url":"https://github.com/AssistantMail/assistantmail-mcp/issues"},"author":{"name":"AssistantMail"},"license":"MIT","homepage":"https://assistant-mail.ai","keywords":["mcp","assistantmail","claude","openai","OpenClaw"],"repository":{"url":"git+https://github.com/AssistantMail/assistantmail-mcp.git","type":"git"},"description":"AssistantMail MCP server","maintainers":[{"name":"assistantmail-owner","email":"developers@assistant-mail.ai"}],"readme":"# assistantmail-mcp\n\nMCP server for [AssistantMail](https://assistant-mail.ai) — give AI agents a managed mailbox to send and receive email.\n\nBuilt for personal and small-team OpenClaw / Hermes operators who want agent email with allowlist, consent, retention, and spend caps you control. Listed on ClawHub for easy install — not an official OpenClaw endorsement.\n\n[Get Free](https://app.assistant-mail.ai/?utm_source=npm&utm_medium=readme&utm_campaign=npm_free&plan=free) · [Docs](https://assistant-mail.ai/docs) · [Website](https://assistant-mail.ai) · [Privacy](https://assistant-mail.ai/privacy.html) · [Terms](https://assistant-mail.ai/terms.html) · [Contributing](./CONTRIBUTING.md)\n\n## OpenClaw / ClawHub\n\n```bash\nopenclaw skills install @assistantmail/assistant-mail\n```\n\nThen configure your MCP client to run this server and set `ASSISTANT_MAIL_API_KEY` (Claude Desktop and Cursor examples below). Skill: [assistant-mail on ClawHub](https://clawhub.ai/assistantmail/skills/assistant-mail). Same MCP works with Hermes.\n\n## Installation\n\n```bash\nnpx -y @assistantmail/assistantmail-mcp\n```\n\nNode 24+.\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"assistantmail\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@assistantmail/assistantmail-mcp\"],\n      \"env\": {\n        \"ASSISTANT_MAIL_API_KEY\": \"amk_...\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / VS Code (`.cursor/mcp.json` or `.vscode/mcp.json`)\n\n```json\n{\n  \"servers\": {\n    \"assistantmail\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@assistantmail/assistantmail-mcp\"],\n      \"env\": {\n        \"ASSISTANT_MAIL_API_KEY\": \"amk_...\"\n      }\n    }\n  }\n}\n```\n\n## Prerequisites\n\n1. Create a free account via the [Get Free](https://app.assistant-mail.ai/?utm_source=npm&utm_medium=readme&utm_campaign=npm_free&plan=free) link above (1 agent, 25/day; current limits: [Docs](https://assistant-mail.ai/docs)).\n2. Go to **API Keys** and create a key (`amk_...`). Copy it immediately — it is only shown once.\n3. Set `ASSISTANT_MAIL_API_KEY`; call `assistantmail_list_mailboxes` to get your `mailboxId` UUID. Mail API routes use that UUID, not an email address.\n\nPaid plans: upgrade in-app only (not Payment Links). Use **Upgrade** in the AssistantMail app — checkout is not sold via Stripe Payment Links. Docs: [assistant-mail.ai/docs](https://assistant-mail.ai/docs)\n\n## Official MCP Registry\n\nThe listing is **live** as [`io.github.AssistantMail/assistantmail-mcp`](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.AssistantMail/assistantmail-mcp) on the Official MCP Registry. Product docs: [assistant-mail.ai/docs](https://assistant-mail.ai/docs).\n\nPackaging lives in [`server.json`](./server.json). After a version bump, republish with `mcp-publisher` — see [docs/MCP_REGISTRY.md](./docs/MCP_REGISTRY.md).\n\n## Environment variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `ASSISTANT_MAIL_API_KEY` | _(none)_ | API key (`amk_...`). Can be omitted if passed per-tool. |\n| `ASSISTANT_MAIL_API_BASE_URL` | `https://api.assistant-mail.ai` | The public API for the AssistantMail service |\n\n## Tools\n\n### Diagnostics\n| Tool | Description |\n|---|---|\n| `assistantmail_health` | Check that the MCP server is running and confirm the API base URL. No API key required. |\n\n### Account\n| Tool | Description |\n|---|---|\n| `assistantmail_get_me` | Get account profile and plan tier. |\n| `assistantmail_get_inbound_policy` | Get the current inbound email policy (who can send to this account's mailboxes). |\n| `assistantmail_update_inbound_policy` | Update the inbound policy (if allowed by selected account tier). Accepted values: `owner`, `list`, `sent`. Use `allowedSenders` with `list`. |\n\n### Mailboxes\n| Tool | Description |\n|---|---|\n| `assistantmail_list_mailboxes` | List all mailboxes on the account. Returns `mailboxId` needed for message operations. |\n| `assistantmail_create_mailbox` | Create a new mailbox (if allowed by selected account tier), optionally specifying `displayName` and `address`. |\n| `assistantmail_get_mailbox` | Get metadata for a single mailbox by `mailboxId`. |\n| `assistantmail_update_mailbox` | Update a mailbox's display name. |\n| `assistantmail_delete_mailbox` | Permanently delete a mailbox and all its messages. THIS ACTION HAS NO CONFIRMATION. USE CAREFULLY. |\n\n### Messages\n| Tool | Description |\n|---|---|\n| `assistantmail_list_messages` | List inbound and outbound messages for a mailbox. Supports `since` (ISO timestamp) and `limit` (max 100). |\n| `assistantmail_get_message` | Fetch a single message including `textBody` and `htmlBody`. Bodies are only returned within the plan's retention window; `bodyExpired: true` is set if the window has elapsed. |\n| `assistantmail_send_email` | Queue an outbound email. Requires `to`, `subject`, and at least one of `text` or `html`. |\n| `assistantmail_reply_message` | Reply to an existing message. Requires `messageId` and at least one of `text` or `html`; recipients and subject are derived automatically. |\n| `assistantmail_delete_messages` | Delete messages by `messageIds` array, or pass `deleteAll: true` to clear the mailbox. |\n| `assistantmail_get_usage` | Get daily and monthly send quota usage for a mailbox. A `null` limit means unlimited. |\n\n### Recipients\n| Tool | Description |\n|---|---|\n| `assistantmail_list_recipients` | List approved and pending recipients for the account. |\n| `assistantmail_add_recipient` | Add a recipient. Sends a consent invitation email when required by the account's plan. |\n| `assistantmail_remove_recipient` | Remove a recipient from the allowed list. |\n\n### Reference tools\nThese return raw REST endpoint details rather than calling the API. Use them when you need to construct a request manually or inspect the exact URL and response schema.\n\n| Tool | Description |\n|---|---|\n| `assistantmail_send_email_reference` | Endpoint, headers, and body fields for `POST /v1/mailboxes/{mailboxId}/messages`. |\n| `assistantmail_list_messages_reference` | Endpoint and query params for `GET /v1/mailboxes/{mailboxId}/messages`. |\n| `assistantmail_get_message_reference` | Endpoint and response schema for `GET /v1/mailboxes/{mailboxId}/messages/{messageId}`. |\n| `assistantmail_get_usage_reference` | Endpoint and response schema for `GET /v1/mailboxes/{mailboxId}/usage`. |\n\n## Quick start\n\n```bash\nAPI_KEY=\"amk_...\"\nBASE=\"https://api.assistant-mail.ai\"\n\n# 1) Discover your mailboxId\ncurl \"$BASE/v1/mailboxes\" -H \"x-api-key: $API_KEY\"\n\n# 2) Send an email\ncurl -X POST \"$BASE/v1/mailboxes/<mailboxId>/messages\" \\\n  -H \"x-api-key: $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"to\":\"recipient@example.com\",\"subject\":\"Hello\",\"text\":\"Hi there\"}'\n\n# 3) Read inbox\ncurl \"$BASE/v1/mailboxes/<mailboxId>/messages\" -H \"x-api-key: $API_KEY\"\n```\n\n## Tool call examples\n\n```json\n{ \"tool\": \"assistantmail_list_mailboxes\", \"input\": { \"apiKey\": \"amk_...\" } }\n```\n\n```json\n{\n  \"tool\": \"assistantmail_list_messages\",\n  \"input\": { \"mailboxId\": \"<uuid>\", \"limit\": 20, \"since\": \"2026-01-01T00:00:00.000Z\" }\n}\n```\n\n```json\n{\n  \"tool\": \"assistantmail_get_message\",\n  \"input\": { \"mailboxId\": \"<uuid>\", \"messageId\": \"<uuid>\" }\n}\n```\n\n```json\n{\n  \"tool\": \"assistantmail_send_email\",\n  \"input\": {\n    \"mailboxId\": \"<uuid>\",\n    \"to\": \"recipient@example.com\",\n    \"subject\": \"Hello\",\n    \"text\": \"Hi there\"\n  }\n}\n```\n\n```json\n{\n  \"tool\": \"assistantmail_reply_message\",\n  \"input\": {\n    \"mailboxId\": \"<uuid>\",\n    \"messageId\": \"<uuid>\",\n    \"text\": \"Thanks for the update.\"\n  }\n}\n```\n\nIf `ASSISTANT_MAIL_API_KEY` is set in the server environment, `apiKey` can be omitted from all tool inputs.\n\n---\n\n[AssistantMail](https://assistant-mail.ai) · [Privacy Policy](https://assistant-mail.ai/privacy.html) · [Terms of Use](https://assistant-mail.ai/terms.html)","readmeFilename":"README.md"}