Nuntly

MCP server forNuntly, the developer-first email platform. Exposes tools for sending emails, managing domains, webhooks, inboxes, and more.

Documentation|SDK Reference|Get your API key

- Requirements
- Setup
- Environment variables
- Programmatic usage
- Tools
- FAQ
- Semantic versioning
- Previous versions
- Contributing
- License

- Node.js 20 or later (or Bun)
- A Nuntly API key fromhttps://nuntly.com/auth/sign-up
- An MCP-aware client: Claude Desktop, Claude Code, Cursor, Continue, or any custom integration based on the Model Context Protocol

{ "mcpServers": { "nuntly": { "command": "npx", "args": ["@nuntly/sdk-mcp"], "env": { "NUNTLY_API_KEY": "your-api-key" } } } }

Use the built-inclaude mcp addcommand:

claude mcp add nuntly -- npx @nuntly/sdk-mcp

Then exportNUNTLY_API_KEYin your shell, or paste this shape into.mcp.jsonmanually:

{ "mcpServers": { "nuntly": { "command": "npx", "args": ["@nuntly/sdk-mcp"], "env": { "NUNTLY_API_KEY": "your-api-key" } } } }

{ "mcpServers": { "nuntly": { "command": "npx", "args": ["@nuntly/sdk-mcp"], "env": { "NUNTLY_API_KEY": "your-api-key" } } } }

createMcpServerreturns a fully-configuredMcpServer(all tools registered); connect it to any transport yourself.

import { createMcpServer } from '@nuntly/sdk-mcp/ai'; import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'; const server = createMcpServer({ apiKey: process.env.NUNTLY_API_KEY }); await server.connect(new StdioServerTransport());

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'; import { Nuntly } from '@nuntly/sdk'; import { registerTools } from '@nuntly/sdk-mcp'; const server = new McpServer({ name: 'my-server', version: '1.0.0' }); const nuntly = new Nuntly({ apiKey: process.env.NUNTLY_API_KEY }); registerTools(server, nuntly);

Agents:retrieve-agent-memory,upsert-agent-memory

API Keys:create-api-key,delete-api-key,list-api-keys,retrieve-api-key,update-api-key

Domains:create-domain,delete-domain,list-domains,retrieve-domain,update-domain

Emails:cancel-email,list-emails,retrieve-bulk-emails,retrieve-email,retrieve-email-content,retrieve-email-events,retrieve-email-stats,send-bulk-emails,send-email

Inboxes:create-inbox,delete-inbox,list-inboxes,retrieve-inbox,send-inbox-message,update-inbox

Messages:forward-message,list-message-attachments,list-messages,reply-to-message,retrieve-message,retrieve-message-attachment,retrieve-message-content,update-message

Namespaces:create-namespace,delete-namespace,list-namespace-inboxes,list-namespaces,retrieve-namespace,update-namespace

Organizations:list-organizations,retrieve-organization,retrieve-organization-usage

Threads:list-inbox-threads,list-thread-messages,retrieve-thread,update-thread

Webhooks:create-webhook,delete-webhook,list-webhooks,retrieve-webhook,update-webhook

Webhooks Events:list-webhook-event-deliveries,list-webhooks-events,replay-webhook-event

Does this require Node.js or Bun?Either. The published package runs on Node.js 20+ vianpx @nuntly/sdk-mcpand on Bun viabunx @nuntly/sdk-mcp. Most MCP clients spawnnpxdirectly.

Do I need an LLM provider account?No. The MCP server only talks to the Nuntly API. The LLM client (Claude Desktop, Cursor, etc.) handles its own provider authentication.

How do I report a bug or request a tool?Open an issue atgithub.com/nuntly/nuntly-mcp/issues.

This package followsSemantic Versioning 2.0. The published version tracks the underlying Nuntly SDK version closely. New tools and tool argument additions are minor bumps; tool removals or argument breaking changes are major bumps.

Issues, bug reports, and feature requests are welcome atgithub.com/nuntly/nuntly-mcp/issues.

NUNTLY_API_KEY missingat startupGrab a key fromnuntly.comand paste it underenvin your MCP client config. The server reads the variable from the spawned process environment, not from your shell.

command not found: npxInstall Node.js 20 or later fromnodejs.org.npxships with Node and is the spawn target used by every MCP client in the examples above.

Context Intelligence API that returns structured, cited answers from email threads, attachments, and Google Drive docs in one API call.