Skip to main content
This page doubles as an executable prompt. Copy the block below into your AI coding agent (Claude Code, Cursor, Codex, Copilot and others) and it will connect itself to the Minimo MCP server. The raw instructions are also available at https://docs.minimo.it/agent-setup.md.

Building a SaaS?

If you want to send email for each of your customers from your own app (for example a booking app for restaurants), start at Start here instead. Your backend calls the API with a key. You do not need the MCP server for that. The Glossary defines the words those pages use.

Copy this into your agent

That’s it. Your agent reads the steps below, adds the Minimo MCP server with the right command for your tool, and confirms when it’s done.

Instructions for the agent

These are official instructions from Minimo to connect an AI agent to a Minimo workspace via the Model Context Protocol (MCP). Complete the steps yourself by running the commands directly. Do not ask the user to run them. The Minimo MCP endpoint is https://api.minimo.it/mcp (Streamable HTTP). Authentication is OAuth (“Sign in with Minimo”): on first tool use a browser window opens and the user clicks Authorize. There is no key to copy. For headless or CI environments, use an mn-… API key with the mcp:invoke permission as a Bearer header instead. If the user asks to set up Minimo for their SaaS (sending email for each of their customers), connecting the MCP server is optional: read https://docs.minimo.it/embedded/start-here.md and follow it, then https://docs.minimo.it/embedded/quickstart.md. While you work in Minimo: reply in the language the user writes in; keep the automations and campaigns you create as disabled drafts and activate, send or schedule only after the user’s explicit OK; send tests only to the user’s own address; read the database connection and the schema analysis before building an automation. Minimo’s MCP server repeats these rules on connect.

Claude Code

Cursor: .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

Add under "mcpServers":

Codex

GitHub Copilot (VS Code): .vscode/mcp.json, Windsurf, and other agents

Add under "mcpServers" (Windsurf uses serverUrl instead of url):

Headless / CI (no browser to sign in)

Pass an API key as a Bearer header. Get one from Settings → Mo & MCP (the “Use Mo everywhere” card) or Developer → API keys with the MCP (AI agent) permission.

Verify

After connecting, confirm it works by asking the agent a read-only question:
If the agent returns a workspace name and a contact count, the connection is live. Then tell the user (in their language):
These instructions are published at https://docs.minimo.it/agent-setup.md so you can re-verify their authenticity at any time. For the human-readable walkthrough per client, see Connect your agent (MCP).