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
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 ishttps://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: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).