From aeb84bc2a696a5dd1d6c56f97e5de9d246ef071e Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 13 Aug 2026 20:54:23 +0000 Subject: [PATCH] Add AgentMail third-party MCP plugin Wire AgentMail's hosted MCP server into the marketplace using the documented Cursor API-key path (x-api-key header). Co-authored-by: Sam Sokolin --- .cursor-plugin/marketplace.json | 5 ++ README.md | 1 + .../agentmail/.cursor-plugin/plugin.json | 47 +++++++++++++ third_party/agentmail/CHANGELOG.md | 9 +++ third_party/agentmail/LICENSE | 21 ++++++ third_party/agentmail/README.md | 66 ++++++++++++++++++ third_party/agentmail/assets/logo.png | Bin 0 -> 6816 bytes third_party/agentmail/mcp.json | 11 +++ 8 files changed, 160 insertions(+) create mode 100644 third_party/agentmail/.cursor-plugin/plugin.json create mode 100644 third_party/agentmail/CHANGELOG.md create mode 100644 third_party/agentmail/LICENSE create mode 100644 third_party/agentmail/README.md create mode 100644 third_party/agentmail/assets/logo.png create mode 100644 third_party/agentmail/mcp.json diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 48d8c26e..9d46ece6 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -159,6 +159,11 @@ "name": "navan", "source": "third_party/navan", "description": "Connect to Navan — query expenses, analyze travel bookings, check policies and approvals, and manage cards — via Navan's official remote MCP server." + }, + { + "name": "agentmail", + "source": "third_party/agentmail", + "description": "Connect to AgentMail — create inboxes, send and receive email, search threads, and manage drafts and attachments — via AgentMail's official hosted MCP server." } ] } diff --git a/README.md b/README.md index 1a7c3b0e..cebd3049 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `docusign` | [Docusign](third_party/docusign/) | Cursor | Integrations | Connect to Docusign — work with eSignature envelopes and templates, Maestro workflows, and Navigator agreements — via Docusign's official remote MCP server (beta). | | `x` | [X](third_party/x/) | Cursor | Integrations | Read-only access to the X API — search posts and users, read timelines and mentions, and pull trends and news — via X's official hosted MCP server. | | `navan` | [Navan](third_party/navan/) | Cursor | Integrations | Connect to Navan — query expenses, analyze travel bookings, check policies and approvals, and manage cards — via Navan's official remote MCP server. | +| `agentmail` | [AgentMail](third_party/agentmail/) | Cursor | Integrations | Connect to AgentMail — create inboxes, send and receive email, search threads, and manage drafts and attachments — via AgentMail's official hosted MCP server. | Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest). ## Repository structure diff --git a/third_party/agentmail/.cursor-plugin/plugin.json b/third_party/agentmail/.cursor-plugin/plugin.json new file mode 100644 index 00000000..e5c0607b --- /dev/null +++ b/third_party/agentmail/.cursor-plugin/plugin.json @@ -0,0 +1,47 @@ +{ + "name": "agentmail", + "displayName": "AgentMail", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Connect to AgentMail — create inboxes, send and receive email, search threads, and manage drafts and attachments — via AgentMail's official hosted MCP server.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://www.agentmail.to/docs/integrations/mcp", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "agentmail", + "email", + "inbox", + "drafts", + "threads", + "mcp", + "agents" + ], + "category": "integrations", + "tags": [ + "agentmail", + "email", + "mcp", + "inbox" + ], + "variables": { + "type": "object", + "properties": { + "AGENTMAIL_API_KEY": { + "type": "string", + "title": "AgentMail API key", + "description": "API key from https://console.agentmail.to under Settings → API Keys. Copy the full value, including the am_ prefix." + } + }, + "required": [ + "AGENTMAIL_API_KEY" + ] + }, + "mcpServers": "./mcp.json" +} diff --git a/third_party/agentmail/CHANGELOG.md b/third_party/agentmail/CHANGELOG.md new file mode 100644 index 00000000..f9f02dd1 --- /dev/null +++ b/third_party/agentmail/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Logo: AgentMail's official GitHub organization mark. +- Added the `agentmail` MCP server pointing at `https://mcp.agentmail.to/mcp`. +- Declared the `AGENTMAIL_API_KEY` plugin variable and forwarded it through the `x-api-key` header, matching AgentMail's documented Cursor API-key path. diff --git a/third_party/agentmail/LICENSE b/third_party/agentmail/LICENSE new file mode 100644 index 00000000..ca2bba77 --- /dev/null +++ b/third_party/agentmail/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/agentmail/README.md b/third_party/agentmail/README.md new file mode 100644 index 00000000..4c257de4 --- /dev/null +++ b/third_party/agentmail/README.md @@ -0,0 +1,66 @@ +# AgentMail + +Cursor plugin that connects agents to [AgentMail](https://agentmail.to) through AgentMail's official hosted [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Give agents their own inboxes: create addresses, send and receive mail, search threads, and manage drafts and attachments. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **AgentMail**. +3. Click **Install**, then set your AgentMail API key (below). + +Or run `/add-plugin agentmail` in chat. + +## MCP + +```json +{ + "mcpServers": { + "agentmail": { + "type": "http", + "url": "https://mcp.agentmail.to/mcp", + "headers": { + "x-api-key": "${AGENTMAIL_API_KEY}" + } + } + } +} +``` + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Inboxes | List, get, create, update, and delete agent inboxes | +| Threads | List, search, get, update, and delete conversations | +| Messages | List, search, send, reply, forward, and update messages; fetch attachments | +| Drafts | Create, list, get, update, send, and delete drafts | + +The hosted runtime is the source of truth for tool names and schemas. Call `list_inboxes` as a read-only smoke test after connecting. + +## Setup + +No credential ships with this plugin — it carries only a `${AGENTMAIL_API_KEY}` placeholder, and each install supplies its own key. + +1. Open the [AgentMail console](https://console.agentmail.to). +2. Go to **Settings → API Keys** and create a key. +3. Copy the full value, including the `am_` prefix. +4. In **Dashboard → Plugins → Configure**, set **AgentMail API key** to that value. + +Tool calls run with that key's organization, pod, and inbox scope. Rotate or revoke the key from the console if it is ever exposed. + +Prefer the `x-api-key` header (what this plugin ships). Query-string keys end up in logs and history. AgentMail also accepts `Authorization: Bearer ` if a client requires that form. + +## Docs + +- AgentMail MCP (Cursor API key): https://www.agentmail.to/docs/integrations/mcp#cursor-api-key +- Hosted server: https://mcp.agentmail.to/mcp +- Console: https://console.agentmail.to +- MCP implementation: https://github.com/agentmail-to/agentmail-mcp + +Logo is AgentMail's official GitHub organization mark. + +## License + +MIT diff --git a/third_party/agentmail/assets/logo.png b/third_party/agentmail/assets/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..3d76751c8f66e69d3dca0260ddb9ea9049abcd0b GIT binary patch literal 6816 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 PJOL^S8uFELmf`;cZFcfm literal 0 HcmV?d00001 diff --git a/third_party/agentmail/mcp.json b/third_party/agentmail/mcp.json new file mode 100644 index 00000000..49aa78e9 --- /dev/null +++ b/third_party/agentmail/mcp.json @@ -0,0 +1,11 @@ +{ + "mcpServers": { + "agentmail": { + "type": "http", + "url": "https://mcp.agentmail.to/mcp", + "headers": { + "x-api-key": "${AGENTMAIL_API_KEY}" + } + } + } +}