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 by contacting support@tinyemail.com 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.

1. Log into ChatGPT and navigate to the interface to create a Custom GPT.

2. Configure the custom GPT using TinyEmail actions (pointing to the REST API endpoints).

3. Set up the authentication by passing your tinyEmail API key via the X-API-Key header or query parameter - api_key.

4. Save your Custom GPT. You can now open it, start a conversation, and use natural language (e.g., "List all my tinyEmail campaigns") to interact with your account.

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.