---
title: "How to connect Mailercloud to Cursor, VS Code, Claude Code and Gemini CLI"
description: "Install the official Mailercloud MCP server in Cursor (one-click link or mcp.json), VS Code with GitHub Copilot, Claude Code and Gemini CLI, with OAuth sign-in or an API key header."
url: https://help.mailercloud.com/en/articles/239-how-to-connect-mailercloud-to-cursor-vs-code-claude-code-and-gemini-cli
collection: "Mailercloud MCP"
updated: 2026-10-26
language: en
---

# How to connect Mailercloud to Cursor, VS Code, Claude Code and Gemini CLI

Install the official Mailercloud MCP server in Cursor (one-click link or mcp.json), VS Code with GitHub Copilot, Claude Code and Gemini CLI, with OAuth sign-in or an API key header.

The official Mailercloud MCP server is a remote Streamable HTTP server at `https://mcp.mailercloud.com/mcp`. Coding tools can sign in with OAuth (you paste your Mailercloud API key on the Mailercloud sign-in page) or send the key directly in an `Authorization` header. Create the key in Mailercloud under Settings > API Keys.

_Last updated: 26 October 2026_

## How do I add Mailercloud to Cursor?

**One-click install:** paste this link into your browser's address bar and open it with Cursor:

`cursor://anysphere.cursor-deeplink/mcp/install?name=mailercloud&config=eyJ1cmwiOiJodHRwczovL21jcC5tYWlsZXJjbG91ZC5jb20vbWNwIn0=`

**Or add it to mcp.json** (~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one project):

`{"mcpServers": {"mailercloud": {"url": "https://mcp.mailercloud.com/mcp"}}}`

Cursor then shows a sign-in prompt for Mailercloud: paste your API key on the sign-in page. To skip sign-in, send the key as a header instead:

`{"mcpServers": {"mailercloud": {"url": "https://mcp.mailercloud.com/mcp", "headers": {"Authorization": "YOUR_API_KEY"}}}}`

Use Mailercloud from Cursor's chat in Agent mode. If Cursor warns about too many tools, switch off the Mailercloud tools you don't need in its MCP settings. Cursor's guides: [MCP](https://cursor.com/docs/context/mcp) and [install links](https://cursor.com/docs/context/mcp/install-links).

## How do I add Mailercloud to VS Code with GitHub Copilot?

1.  Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows and Linux) and run MCP: Add Server.
    
2.  Choose HTTP and enter https://mcp.mailercloud.com/mcp.
    
3.  Enter the server ID mailercloud and choose where to save it (Global for just you).
    
4.  Accept the trust and sign-in prompts, and paste your API key on the Mailercloud sign-in page.
    
5.  In Copilot Chat in agent mode, ask: "Using the Mailercloud MCP server, list my latest campaigns."
    

VS Code's guide: [Use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

## How do I add Mailercloud to Claude Code?

Run this in your terminal:

`claude mcp add --transport http mailercloud https://mcp.mailercloud.com/mcp`

Then type /mcp in Claude Code, choose mailercloud and sign in. To use an API key header instead, add `--header "Authorization: YOUR_API_KEY"` to the command.

## How do I add Mailercloud to Gemini CLI?

`gemini mcp add --transport http mailercloud https://mcp.mailercloud.com/mcp`

Then run /mcp auth mailercloud and sign in (this needs a browser on the same computer). Check it with gemini mcp list. Google's guide: [MCP servers with Gemini CLI](https://geminicli.com/docs/tools/mcp-server).

## Can I use Mailercloud with other MCP clients?

Yes. Any client that supports remote Streamable HTTP MCP servers works. Use the URL https://mcp.mailercloud.com/mcp with OAuth 2.0 (dynamic client registration with PKCE), or send your API key in the Authorization or X-API-Key header.

## Is it safe to use in an agent?

Every Mailercloud tool is marked as read-only or as one that changes data, so your client can ask before changes. Tools that send, schedule, delete or block return a preview first and only act when called again with confirmation, and most create and update tools accept a dry run. Keep your API key out of shared or committed config files; use a separate key per tool so you can delete one without affecting the others.

More: [Mailercloud MCP tool reference](https://help.mailercloud.com/en/articles/170-mailercloud-mcp-tool-reference-all-77-tools.md) · [Mailercloud + AI for power users](https://help.mailercloud.com/en/articles/235-mailercloud-ai-for-power-users.md) · Help: [support@mailercloud.com](mailto:support@mailercloud.com)
