{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/email-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Mailjet MCP Server: Claude Desktop Setup","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","description":"Connect Claude Desktop to the local Mailjet Model Context Protocol server for account data. Find setup instructions, credential guidance and troubleshooting.","image":"https://dev.mailjet.com/og-image.png","lang":"en-US","keywords":["Mailjet API","Email API","Content API","SMTP Relay","transactional email","email delivery","Send API","email templates","developer documentation"],"meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Mailjet Developer Documentation"},{"name":"twitter:card","content":"summary_large_image"},{"name":"robots","content":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1"},{"name":"googlebot","content":"index, follow, max-snippet:-1, max-image-preview:large"}],"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://dev.mailjet.com/#organization","name":"Mailjet","alternateName":"Sinch Mailjet","url":"https://www.mailjet.com","logo":"https://assets.mailjet.com/lib/images/mailjetLogo/mj_logo_with_text_color.png","parentOrganization":{"@type":"Organization","name":"Sinch","url":"https://www.sinch.com"}},{"@type":"WebSite","@id":"https://dev.mailjet.com/#website","name":"Mailjet Developer Documentation","description":"Official developer documentation for the Mailjet Email API, Content API and SMTP Relay.","url":"https://dev.mailjet.com/","inLanguage":"en-US","publisher":{"@id":"https://dev.mailjet.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://dev.mailjet.com/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]},"llmstxt":{"hide":false,"title":"Mailjet Developer Documentation","description":"Developer documentation for the Mailjet Email API, Content API and SMTP Relay - guides, API references and code samples for sending, templating and tracking email at scale.","details":{"content":"Mailjet (part of Sinch) provides APIs for sending and managing email.\n\nThis documentation covers four main areas:\n\n- **Email API** - the Send API (v3 and v3.1) for transactional and marketing email,\n  plus contact management, segmentation, campaigns, statistics, webhooks, the Parse API\n  and the Mailjet Templating Language.\n- **Content API** - programmatic management of email templates, template contents,\n  images, labels and authentication tokens (v1).\n- **SMTP Relay** - sending through Mailjet's SMTP servers, including custom headers.\n- **API Reference** - the complete, generated reference for every endpoint, built directly\n  from the OpenAPI specifications.\n\nBase URL for all REST APIs: `https://api.mailjet.com`.\nAuthentication uses HTTP Basic auth with an API key and secret key.\n\n## Machine-readable entry points\n\nPrefer these when you need the API surface in as few requests as possible:\n\n- `/openapi/openapi-mailjet.md` - the **complete** Email API reference (every endpoint,\n  grouped by resource) as a single Markdown document.\n- `/openapi/openapi-passport.md` - the **complete** Content API reference as a single\n  Markdown document.\n- `/_bundle/openapi/openapi-mailjet.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Email API.\n- `/_bundle/openapi/openapi-passport.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Content API.\n- `/sitemap.xml` - every indexable URL on this site.\n\nEvery page on this site is also available as clean Markdown by appending `.md` to its URL."},"sections":[{"title":"Email API","description":"Sending, contacts, campaigns, statistics, webhooks and templating.","includeFiles":["docs/email-api/**/*.md"],"excludeFiles":[]},{"title":"Content API","description":"Manage templates, template contents, images, labels and tokens.","includeFiles":["docs/content-api/**/*.md","docs/content-api.md"],"excludeFiles":[]},{"title":"SMTP Relay","description":"Send email through Mailjet's SMTP servers.","includeFiles":["docs/smtp-relay/**/*.md"],"excludeFiles":[]},{"title":"API Reference","description":"Complete generated reference for every Mailjet API endpoint.","includeFiles":["openapi/openapi-mailjet.yaml","openapi/openapi-passport.yaml","docs/api-reference/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mailjet-mcp-server-and-claude","__idx":0},"children":["Mailjet MCP Server and Claude"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/mailgun/mailjet-mcp-server"},"children":["official Mailjet MCP server"]}," runs locally on your computer and lets an MCP-compatible AI client, such as Claude Desktop, retrieve data from your Mailjet account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MCP (Model Context Protocol) lets AI clients connect to external tools and data sources. For the complete installation walkthrough, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://documentation.mailjet.com/hc/en-us/articles/42810091203867-Installing-the-Mailjet-MCP-Server"},"children":["Installing the Mailjet MCP Server"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"documentation-search-or-account-data","__idx":1},"children":["Documentation search or account data?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are two different integrations:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Integration"},"children":["Integration"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Connection"},"children":["Connection"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Documentation MCP server"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search this documentation and inspect API descriptions. It does not retrieve your Mailjet account data."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.mailjet.com/mcp"]}," as the endpoint in a compatible MCP client."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Local Mailjet MCP server"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve data from your Mailjet account, such as contacts, campaigns and statistics."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Install the server locally and configure your client with Mailjet API credentials, as described below."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the local server when you want Claude to work with your account data, not just explain how the API works."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":2},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Mailjet account with an active API key and secret key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Claude Desktop installed, with permission to configure local MCP servers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Git, Node.js 20.11.1 or later and pnpm installed. Use a supported Node.js LTS release and check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/mailgun/mailjet-mcp-server"},"children":["server repository"]}," for current runtime requirements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Permission under your organization's policies to make the requested account data available to your AI client."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-local-server","__idx":3},"children":["Install the local server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download the official repository and install its dependencies:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"git clone https://github.com/mailgun/mailjet-mcp-server.git\ncd mailjet-mcp-server\npnpm install\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For installation help, see the Help Center's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://documentation.mailjet.com/hc/en-us/articles/42810091203867-Installing-the-Mailjet-MCP-Server#01MJETMCP003"},"children":["download and installation steps"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-claude-desktop","__idx":4},"children":["Connect Claude Desktop"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open Claude Desktop's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude_desktop_config.json"]}," file:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operating system"},"children":["Operating system"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Configuration file"},"children":["Configuration file"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["macOS"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/Library/Application Support/Claude/claude_desktop_config.json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Windows"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["%APPDATA%\\Claude\\claude_desktop_config.json"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merge the following entry into your existing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcpServers"]}," object. Do not replace entries for other servers."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"mailjet\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mailjet-mcp-server/src/mailjet-mcp.js\"],\n      \"env\": {\n        \"MAILJET_API_KEY\": \"YOUR_PUBLIC_API_KEY:YOUR_PRIVATE_API_KEY\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace the script path with the absolute path to your checkout; do not use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~"]}," or shell variables in the path. On Windows, escape backslashes in JSON, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C:\\\\path\\\\to\\\\mailjet-mcp-server\\\\src\\\\mailjet-mcp.js"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAILJET_API_KEY"]}," value contains your public API key and secret key joined by a colon. Replace the placeholders only in your local configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the file and fully restart Claude Desktop. Claude launches the local server using the configured command; it does not connect to the documentation MCP endpoint for account access."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claude starts its own server process from this configuration, so you don't need to keep a separate server running in a terminal. If you start the server manually, for example to test it, set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAILJET_API_KEY"]}," in your local environment first; otherwise startup fails."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The local server validates your API credentials with Mailjet when it starts, before Claude asks you to approve any tool. It needs working credentials and network access to the Mailjet API to complete startup."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credentials-and-permissions","__idx":5},"children":["Credentials and permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat the API key and secret key as credentials. The example stores them as plain text in your local configuration file, so restrict access to that file. Do not paste credentials into an AI conversation, commit them to a repository, or include them in logs or screenshots. The JSON values are literal strings; shell variable references are not a substitute for credentials here."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server exposes read-only tools: it retrieves account data rather than sending emails or changing Mailjet settings. That does not make the underlying API credentials read-only. Protect them and use an appropriate API key for the account or subaccount you intend to access."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Although the server runs locally, data returned to Claude can be processed by the AI provider. Review the requested tool and data access before approving it, and follow your organization's data-handling policies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remove the server entry from your client configuration when you no longer want that client to access the account. If credentials are exposed, revoke or rotate them in Mailjet."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"check-the-connection","__idx":6},"children":["Check the connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After restarting Claude Desktop, confirm that the Mailjet tools are available. For your first account query, choose a read-only task, such as retrieving campaign statistics."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Claude asks to use a tool, review the request and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow once"]}," for the initial check. Confirm that the response relates to the intended account. You can change or revoke permissions in Claude Desktop."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":7},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Problem"},"children":["Problem"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to check"},"children":["What to check"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mailjet tools do not appear"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check that the configuration is valid JSON, the entry is inside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcpServers"]},", and the script path is absolute. Fully restart Claude Desktop."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Node.js cannot be found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure Node.js is installed and available to Claude Desktop. If necessary, set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["command"]}," to the absolute path to the Node.js executable."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server cannot load its dependencies"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnpm install"]}," inside the server checkout, then restart Claude Desktop."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication fails"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAILJET_API_KEY"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUBLIC_KEY:SECRET_KEY"]},", with a colon between the two values, and that both credentials belong to the intended active API key. Do not share the values when requesting help."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server exits before showing tools"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Startup includes an API authentication check. Check credentials, network connectivity and the client's MCP server logs; a process starting does not by itself confirm a successful connection."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full walkthrough and further troubleshooting, refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://documentation.mailjet.com/hc/en-us/articles/42810091203867-Installing-the-Mailjet-MCP-Server"},"children":["Mailjet Help Center setup guide"]},". For source code and repository-specific requirements, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/mailgun/mailjet-mcp-server"},"children":["mailgun/mailjet-mcp-server"]},"."]}]},"headings":[{"value":"Mailjet MCP Server and Claude","id":"mailjet-mcp-server-and-claude","depth":1},{"value":"Documentation search or account data?","id":"documentation-search-or-account-data","depth":2},{"value":"Requirements","id":"requirements","depth":2},{"value":"Install the local server","id":"install-the-local-server","depth":2},{"value":"Connect Claude Desktop","id":"connect-claude-desktop","depth":2},{"value":"Credentials and permissions","id":"credentials-and-permissions","depth":2},{"value":"Check the connection","id":"check-the-connection","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2}],"frontmatter":{"title":"Mailjet MCP Server and Claude","seo":{"title":"Mailjet MCP Server: Claude Desktop Setup","description":"Connect Claude Desktop to the local Mailjet Model Context Protocol server for account data. Find setup instructions, credential guidance and troubleshooting."}},"lastModified":"2026-11-11T16:04:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/email-api/developer-tools/mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}