{"_id":"@skanda-yutori/mcp-send-email","name":"@skanda-yutori/mcp-send-email","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@skanda-yutori/mcp-send-email","version":"1.0.0","description":"MCP server for sending emails via Resend API","main":"build/index.js","bin":{"mcp-send-email":"build/index.js"},"keywords":["mcp","email","resend","model-context-protocol"],"dependencies":{"@modelcontextprotocol/sdk":"^1.5.0","@react-email/components":"^0.0.33","@react-email/render":"^1.0.5","minimist":"^1.2.8","resend":"^4.1.2","zod":"^3.24.2"},"devDependencies":{"@types/minimist":"^1.2.5","@types/node":"^22.13.5","@types/react":"^18.2.64","@types/react-dom":"^18.2.21","typescript":"^5.7.3"},"type":"module","scripts":{"build":"tsc","prepublishOnly":"npm run build && node -e \"require('fs').chmodSync('build/index.js', '755')\""},"engines":{"node":">=18.0.0"},"_id":"@skanda-yutori/mcp-send-email@1.0.0","gitHead":"96ec3d20fea4ca308dbcd8b6dab6176914420ab7","_nodeVersion":"20.17.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-OT2C1v8WsziufGIH2ji4kvv9oh10rSvG188EIVA0DsAo1Eb2YranijFHdBQC/d5zXryKf5CTtxXanCpdFQdCng==","shasum":"5677d26628625952927c95a3fed5a5e69c438825","tarball":"https://registry.npmjs.org/@skanda-yutori/mcp-send-email/-/mcp-send-email-1.0.0.tgz","fileCount":4,"unpackedSize":14881,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBGXY5haE01+CJstekt88HLGPl5CxlIKOQiou4pZCbc+AiEA3vx9oM0mKoPA8DjiOU4mZvGbRdO8tkzsF0dg08e+/wI="}]},"_npmUser":{"name":"skanda-yutori","email":"skanda@yutori.ai","actor":{"name":"skanda-yutori","email":"skanda@yutori.ai","type":"user"}},"directories":{},"maintainers":[{"name":"skanda-yutori","email":"skanda@yutori.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-send-email_1.0.0_1750783464704_0.47532451793054276"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-24T16:44:24.587Z","1.0.0":"2025-06-24T16:44:24.978Z","modified":"2025-06-24T16:44:25.299Z"},"maintainers":[{"name":"skanda-yutori","email":"skanda@yutori.ai"}],"description":"MCP server for sending emails via Resend API","keywords":["mcp","email","resend","model-context-protocol"],"readme":"# MCP Send Email Server\n\nA Model Context Protocol (MCP) server for sending emails using the Resend API. This package can be used as an MCP server or as a standalone CLI tool.\n\n## Installation\n\n### As an npx package (recommended)\n\n```bash\nnpx @your-username/mcp-send-email --key YOUR_RESEND_API_KEY\n```\n\n### As a global package\n\n```bash\nnpm install -g @your-username/mcp-send-email\nmcp-send-email --key YOUR_RESEND_API_KEY\n```\n\n### As a local dependency\n\n```bash\nnpm install @your-username/mcp-send-email\n```\n\n## Prerequisites\n\n1. **Resend API Key**: Get your API key from [Resend](https://resend.com)\n2. **Node.js**: Version 18 or higher\n\n## Configuration\n\n### Environment Variables\n\nYou can configure the server using environment variables:\n\n- `RESEND_API_KEY`: Your Resend API key (required)\n- `SENDER_EMAIL_ADDRESS`: Default sender email address (optional)\n- `REPLY_TO_EMAIL_ADDRESSES`: Comma-separated list of reply-to email addresses (optional)\n\n### Command Line Arguments\n\n- `--key`: Resend API key\n- `--sender`: Default sender email address\n- `--reply-to`: Reply-to email address(es)\n\n## Usage\n\n### As an MCP Server\n\nThe server runs on stdio and can be integrated with MCP clients:\n\n```bash\nnpx @your-username/mcp-send-email --key YOUR_API_KEY\n```\n\n### MCP Configuration\n\nAdd this to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"email\": {\n      \"command\": \"npx\",\n      \"args\": [\"@your-username/mcp-send-email\", \"--key\", \"YOUR_API_KEY\"]\n    }\n  }\n}\n```\n\n### Available Tools\n\nThe server provides a `send-email` tool with the following parameters:\n\n- `to` (required): Recipient email address\n- `subject` (required): Email subject line\n- `text` (required): Plain text email content\n- `html` (optional): HTML email content\n- `from` (optional): Sender email address (if not configured globally)\n- `replyTo` (optional): Reply-to email addresses\n- `cc` (optional): CC email addresses\n- `bcc` (optional): BCC email addresses\n- `scheduledAt` (optional): Schedule email using natural language (e.g., \"tomorrow at 10am\")\n\n## Examples\n\n### Basic Email\n\n```javascript\n// Using the MCP tool\nawait sendEmail({\n  to: \"recipient@example.com\",\n  subject: \"Hello from MCP\",\n  text: \"This is a test email sent via MCP server.\"\n});\n```\n\n### HTML Email with Scheduling\n\n```javascript\nawait sendEmail({\n  to: \"recipient@example.com\",\n  subject: \"HTML Email\",\n  text: \"Plain text fallback\",\n  html: \"<h1>Hello!</h1><p>This is an HTML email.</p>\",\n  scheduledAt: \"tomorrow at 9am PST\"\n});\n```\n\n## Development\n\n### Building from Source\n\n```bash\ngit clone https://github.com/your-username/mcp-send-email.git\ncd mcp-send-email\nnpm install\nnpm run build\n```\n\n### Running in Development\n\n```bash\nnpm install\nnpm run build\nnode build/index.js --key YOUR_API_KEY\n```\n\n## Publishing Updates\n\n1. Update the version in `package.json`\n2. Update `CHANGELOG.md`\n3. Build the project: `npm run build`\n4. Publish to npm: `npm publish`\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## Support\n\n- Issues: [GitHub Issues](https://github.com/your-username/mcp-send-email/issues)\n- Documentation: [GitHub README](https://github.com/your-username/mcp-send-email#readme)\n\n# Email sending MCP 💌\n\n[![smithery badge](https://smithery.ai/badge/@resend/mcp-send-email)](https://smithery.ai/server/@resend/mcp-send-email)\n\nThis is a simple MCP server that sends emails using Resend's API. Why? Now you can let Cursor or Claude Desktop compose emails for you and send it right away without having to copy and paste the email content.\n\nAs an example, you could use this to run local scripts, chat with Claude, or process data and send the results to yourself or your team.\n\nBuilt with:\n\n- [Resend](https://resend.com/)\n- [Anthropic MCP](https://docs.anthropic.com/en/docs/agents-and-tools/mcp)\n- [Cursor](https://cursor.so/)\n\n## Features\n\n- Send plain text and HTML emails\n- Schedule emails for future delivery\n- Add CC and BCC recipients\n- Configure reply-to addresses\n- Customizable sender email (requires verification)\n\n## Demo\n\nhttps://github.com/user-attachments/assets/8c05cbf0-1664-4b3b-afb1-663b46af3464\n\n## Setup\n\nCurrently, you must build the project locally to use this MCP server. Then add the server in [Cursor](#cursor) or [Claude Desktop](#claude-desktop) to use it in any Cursor or Claude Desktop chat.\n\n1. Clone this project locally.\n\n```\ngit clone https://github.com/resend/mcp-send-email.git\n```\n\n2. Build the project\n\n```\nnpm install\nnpm run build\n```\n3. Setup Resend\n\nCreate a free Resend account and [Create an API Key](https://resend.com/api-keys). To send to other addresses, you'll also need to [verify your own domain](https://resend.com/domains).\n\n> [!NOTE]\n> For more info on how to send emails with Resend, see the [docs](https://resend.com/docs/send-with-nodejs).\n\n## Cursor\n\n1. Open Cursor Settings.\n\nOpen the command palette (`cmd`+`shift`+`p` on macOS or `ctrl`+`shift`+`p` on Windows) and choose \"Cursor Settings\".\n\n2. Add the MCP server\n\nSelect \"MCP\" from the left sidebar and click \"Add new global MCP server\".\n\nAdd the following config:\n```json\n{\n  \"mcpServers\": {\n    \"resend\": {\n      \"type\": \"command\",\n      \"command\": \"node ABSOLUTE_PATH_TO_MCP_SEND_EMAIL_PROJECT/build/index.js --key=YOUR_RESEND_API_KEY\"\n    }\n  }\n}\n```\n\nYou can get the absolute path to your build script by right-clicking on the `/build/index.js` file in Cursor and selecting `Copy Path`.\n\n**Possible arguments**\n\n- `--key`: Your Resend API key (required)\n- `--sender`: Your sender email address from a verified domain (optional)\n- `--reply-to`: Your reply-to email address (optional)\n\n> [!NOTE]\n> If you don't provide a sender email address, the MCP server will ask you to provide one each time you call the tool.\n\n3. Test the sending\n\nNow you can test out sending emails by going to `email.md`.\n- Replace the to: email address with your own\n- Select all text in `email.md`, and press `cmd+l`\n- Tell cursor to \"send this as an email\" in the chat (make sure cursor is in Agent mode by selecting \"Agent\" on lower left side dropdown).\n\n<img width=\"441\" alt=\"Cursor chat with email.md file selected and Agent mode enabled\" src=\"https://github.com/user-attachments/assets/b07e9cbf-42d8-4910-8e90-3761d8d3bc06\" />\n\n## Claude Desktop\n\n1. Open Claude's Developer config file\n\nOpen Claude Desktop settings and navigate to the \"Developer\" tab. Click `Edit Config`.\n\n2. Add the MCP server\n\nAdd the following config:\n\n```json\n{\n  \"mcpServers\": {\n    \"resend\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"ABSOLUTE_PATH_TO_MCP_SEND_EMAIL_PROJECT/build/index.js\"\n      ],\n      \"env\": {\n        \"RESEND_API_KEY\": \"YOUR_RESEND_API_KEY\",\n      }\n    }\n  }\n}\n```\n\nYou can get the absolute path to your build script by right-clicking on the `/build/index.js` file in your IDE and selecting `Copy Path`.\n\n**Possible environment variables**\n\n- `RESEND_API_KEY`: Your Resend API key (required)\n- `SENDER_EMAIL_ADDRESS`: Your sender email address from a verified domain (optional)\n- `REPLY_TO_EMAIL_ADDRESS`: Your reply-to email address (optional)\n\n> [!NOTE]\n> If you don't provide a sender email address, the MCP server will ask you to provide one each time you call the tool.\n\n3. Test the sending\n\nClose and reopen Claude Desktop. Verify that the `resend` tool is available in the Claude developer settings.\n\n![Claude Desktop developer settings with Resend MCP server showing](https://github.com/user-attachments/assets/be9549e5-eaef-4946-b10a-e708c1864acf)\n\nChat with Claude and tell it to send you an email using the `resend` tool.\n","readmeFilename":"README.md","_rev":"1-768508bbc241561274da3bd5da6ad02f"}