How to use the systeme.io MCP server (Model Context Protocol)

The new MCP server feature gives users, partners, and developers a powerful new way to interact with systeme.io using AI tools.

What is MCP?

MCP (Model Context Protocol) is a standard that enables AI assistants (such as ChatGPT or Claude) to connect securely to external platforms.

With MCP, you can use natural language commands to interact with your systeme.io data. For example, you can ask ChatGPT to find a contact or add a tag just by typing a sentence.

Our MCP feature currently provides direct access to specific contact-management features, allowing you to use AI to manage your contacts, tags, and contact fields.

How does our MCP server work?

The systeme.io MCP server allows AI applications to access specific contact-management tools within your account.

It creates a bridge between:

• The host: Your AI tool (e.g., ChatGPT, Claude).
• The server: Your systeme.io account.

Once connected, the AI can execute commands to manage your contacts and tags automatically.

For technical details, please refer to our official MCP documentation: https://developer.systeme.io/docs/mcp-server

How to generate your MCP keys

To connect an AI tool, you first need to generate a secure MCP key.

Click on your profile picture and select Settings (1).

In the left menu, click MCP & API keys (2).

Scroll down to the MCP keys section and click Create (3).

Give your key a name, set an expiration date, and click Save (4).

Your key is now ready.

What can you do with our MCP server?

You can use AI tools to perform the following actions:

• Create and update contacts: Add new contacts or update existing ones.
• Delete contacts: Remove contacts from your list.
• List and retrieve contacts: Use filters to list contacts or fetch specific contact details.
• Manage tags: Create, assign, list, and remove tags from contacts.
• Retrieve contact fields (custom fields): List available contact fields and their identifiers (slugs) so the AI can correctly fill in and update contact information.

How to integrate your account with ChatGPT using MCP keys

Connecting ChatGPT to your systeme.io account is simple. You’ll need a ChatGPT plan/workspace that supports connecting to MCP servers/external tools.

For a detailed step-by-step walkthrough, see our complete guide on integrating ChatGPT with systeme.io using MCP keys: https://developer.systeme.io/docs/mcp-integration-with-chatgpt.

How to integrate your account with Claude using MCP keys (on Windows)

To connect your systeme.io account to Claude Desktop, you will need to add your MCP key to your claude_desktop_config.json file.

If you experience "Server disconnected" errors or infinite loading, you will need to tweak your configuration to bypass standard Windows limitations. Make sure you apply the following rules:

1. Use the Windows short path: If Node.js is installed in a folder with spaces (like C:\Program Files\nodejs), it will break the background connection. Use the short path "C:\\PROGRA~1\\nodejs\\npx.cmd" instead of simply "npx" .
2. Add the -y   flag: Include "-y"   in your arguments to bypass hidden installation prompts that can cause the connection to hang.
3. Include the /mcp   URL suffix: Ensure your endpoint URL is exactly https://mcp.systeme.io/mcp   (the base URL alone will not work).

Example of a working Windows configuration:

"systeme-io": {
  "command": "C:/PROGRA~1/nodejs/npx.cmd",
  "args":[
    "-y",
    "mcp-remote",
    "https://mcp.systeme.io/mcp",
    "--header",
    "X-MCP-Key: <YOUR_MCP_KEY_HERE>"
  ]
}