Integrating AI Assistants with tinyEmail via MCP Server

Integrating AI Assistants with tinyEmail via MCP Server

The tinyEmail MCP (Model Context Protocol) Server is an integration layer that lets you securely connect external AI assistants directly to your tinyEmail account. Once connected, you can manage campaigns, audiences, senders, email templates and more using simple natural-language requests.

The MCP server acts as a bridge: when you type a request, your AI assistant matches it to a tinyEmail tool (such as list_campaigns or create_audience), and the MCP server runs it through the tinyEmail API.

Before you start (required)

Make sure you have the following before you begin:

  1. A tinyEmail Enterprise account.
  2. A tinyEmail API key. You can get one at My Account → API Keys or through the in-app chat.
Note: Your API key is sent securely in the X-API-Key header from your AI client to the tinyEmail API and is never stored by the MCP server.

For a visual walkthrough, watch our YouTube video: Connect Claude & ChatGPT to tinyEmail — MCP Server

1. Choose and configure your AI assistant

The tinyEmail MCP server is hosted at https://mcp.tinyemail.com/mcp and requires your API key in the X-API-Key header. Follow the steps for your preferred client.

Option A: Claude Code (CLI)

Claude Code supports the MCP protocol directly from your terminal.

  1. Open your terminal.
  2. Either run the configuration command directly in your CLI, or edit your Claude Code settings file at ~/.claude/settings.json.
  3. Add the tinyEmail server URL (https://mcp.tinyemail.com/mcp) and set the X-API-Key header to your tinyEmail API key.
  4. Start a new session to load the tools automatically.

Option B: Claude Desktop

Claude Desktop uses a remote bridge to connect to the tinyEmail HTTP server.

  1. Install Node.js. Node.js is required to run the remote bridge.
  2. Find your configuration file.
    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Edit the file. Configure it to bridge to the tinyEmail HTTP server (https://mcp.tinyemail.com/mcp) and pass your X-API-Key header. It should look like this:
    {
    "mcpServers": {
    "tinyemail": {
    "command": "npx",
    "args": [
    "mcp-remote",
    "https://mcp.tinyemail.com/mcp",
    "--header",
    "X-API-Key:YOUR_TINYEMAIL_API_KEY"
    ]
    }
    }
    }
  4. Restart the app. Save the file and restart Claude Desktop. The tinyEmail tools now appear in the tool picker (the 🔨 hammer icon) in your chat input bar.

Option C: ChatGPT (web)

ChatGPT connects to the same tinyEmail MCP server through custom apps (developer mode).

  1. In ChatGPT, go to Settings → Apps → Advanced settings → Create app.
  2. In the New App dialog, enter a Name (for example, tinyEmail). An icon and description are optional.
  3. Under Connection, keep Server URL selected and enter the MCP URL with your API key added at the end:
    https://mcp.tinyemail.com/mcp?api_key=YOUR_TINYEMAIL_API_KEY
  4. Set Authentication to No Auth (your key is already in the URL).
  5. Check I understand and want to continue to acknowledge the custom-server warning, then click Create.
  6. Your tinyEmail app is now available. Open any chat and ask, for example, “List all my tinyEmail campaigns.”
Keep your URL private. Because the API key is in the URL, treat that URL like a password. Don’t share it or show it on screen.

2. Testing your setup

Once you have configured your client, check that the connection works.

Claude Desktop and Claude Code

  1. Look for the available tools (for example, list_campaigns, create_campaign). In Claude Desktop, click the hammer icon (🔨) to see the tool list.
  2. Type a test request, such as “List all my tinyEmail campaigns.”
  3. The assistant should call the list_campaigns tool and show your results.
Troubleshooting: If you get an error in Claude Desktop, check your connection logs and make sure Node.js is installed correctly.

ChatGPT

  1. Open a new chat with your tinyEmail app.
  2. Type “List all my tinyEmail campaigns.”
  3. ChatGPT calls tinyEmail and shows your results.

3. Managing email templates

You can create, update, clone and delete email templates by asking your assistant, for example “List my saved templates” or “Clone my Spring Sale template and change the headline.” Templates created or changed this way appear in your Templates list in tinyEmail and can be edited there as usual.

MCP toolWhat it does
list_templatesLists the saved templates in your account
get_templateGets one template and its content
create_templateCreates a new template
update_templateUpdates an existing template
clone_templateCreates a copy of an existing template
delete_templateDeletes a template

Creating campaigns from a template

The campaign create and send tools accept an optional template_id as an alternative to content. Provide one or the other: if you send both, you get a clear validation error. The campaign gets its own copy of the template content, so later edits to the campaign don’t affect the template.

Safe and permission-aware. Deleting or overwriting a template is clearly flagged to your assistant, so it confirms with you before doing it. All template tools use the same API key and account permissions as the API.

To learn more about templates in the app, see Create a New Email Template.