The tinyEmail MCP (Model Context Protocol) Server is an integration layer that allows you to securely connect external AI assistants directly to your tinyEmail account. By configuring this connection, you can manage campaigns, audiences, senders, and more using simple natural language commands.

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

Before You Start (Required)

Please ensure you have the following before proceeding with the setup:

1. tinyEmail Enterprise account

2. tinyEmail API key — You can obtain this at My Account - API Keys or by using the in-app chat.
   

1. Choose and Configure Your AI Assistant

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

Option A: Claude Code (CLI)

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

Option B: Claude Desktop

Claude Desktop natively supports stdio MCP, so a remote bridge is used to connect it to our HTTP server.

1. Install Node.js: Ensure Node.js is installed on your computer, as it is required to run the remote bridge.

2. Locate your configuration file:

1. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Edit the file. Open the JSON file and configure it to bridge to the tinyEmail HTTP server (https://mcp.tinyemail.com/mcp), ensuring you pass your X-API-Key header.

4. 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" ] } } }

5. Restart the app. Save the file and restart Claude Desktop. The tinyEmail tools will now appear in the tool picker (the 🔨 hammer icon) in your chat input bar.

Option C: ChatGPT (Web)

ChatGPT does not currently support the native MCP protocol. Instead, it uses OpenAI's GPT Actions system. However, ChatGPT can now connect directly to the tinyEmail MCP server through custom apps (developer mode), using the same MCP server that is also used by Claude.

1. In ChatGPT, go to Settings → Apps → Advanced settings → Create app.
   

2. In the New App dialog, give it a Name (e.g. tinyEmail). An icon and description are optional.
   

3. Under Connection, keep Server URL selected and enter the tinyEmail MCP URL with your API key appended as a query parameter: 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. Acknowledge the custom-server warning by checking "I understand and want to continue", then click Create.
   

6. Your tinyEmail app is now available. Open any chat and use natural language (e.g. "List all my tinyEmail campaigns") to interact with your account.
   
   Note: Because the API key is in the URL, treat that URL like a password — don't share it or expose it on screen.
   

2. Testing Your Setup

Once you have configured your chosen client, you should verify the connection.

For Claude Desktop & Claude Code:

1. Open your chat input and look for the available tools (e.g., list_campaigns, create_campaign). In Claude Desktop, you can click the hammer icon (🔨) to see the tool list.

2. Type a test prompt, such as: "List all my tinyEmail campaigns".

3. The AI should successfully call the list_campaigns tool and display your results. Troubleshooting: If you receive an error in Claude Desktop, check your connection logs or ensure that Node.js is properly installed on your system.

For ChatGPT:

1. Open your custom GPT.

2. Type: "List all my tinyEmail campaigns".

3. ChatGPT will call the tinyEmail API directly and display your results.