Skip to main content
Connect Claude, Cursor, ChatGPT or any MCP client to your Minimo workspace. Your agent can then read and act on it (contacts, segments, email and WhatsApp templates, campaigns, automations, connection status) through Mo’s tools.

Example

The first time a tool runs, a Minimo window opens: click Authorize. Steps for every client are below. The endpoint is https://api.minimo.it/mcp (Streamable HTTP). Most clients (Claude, ChatGPT, Cursor) don’t need an API key: point them at the URL and they discover the Minimo sign-in automatically (OAuth). You just click Authorize. For scripts, automations and clients that can’t run a sign-in flow, use an API key: an mn-… key with the MCP (AI agent) permission (mcp:invoke), sent as a Bearer token in the Authorization header.
Want your agent to set this up itself? Point it at the agent-setup instructions: a single prompt that installs the connection for you.

Get an API key

1

From the dashboard (fastest)

In Settings → Mo & MCP, the “Use Mo everywhere” card shows your key already generated. Copy it straight from the input. It’s scoped to MCP only and valid for 1 year.
2

Or from Developer settings

Go to Developer → API keys, create a new key and select the MCP (AI agent) permission.
3

Copy it immediately

The key is shown once. Store it securely: you won’t be able to see it again.
API keys are sensitive credentials. Treat them like passwords and never commit them to public repositories.

Claude (claude.ai)

1

Add the custom connector

Open Claude → Settings → Connectors and click Add custom connector. Name it Minimo and set the URL to https://api.minimo.it/mcp.
2

Authorize

Press Add, then Connect. A Minimo window opens: click Authorize. No key to copy.

Claude Code (CLI)

When prompted, click Authorize in the browser. For headless / CI use, pass a key instead:

Cursor

Add Minimo to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
Reload Cursor and click Authorize when Minimo asks. For headless use, add the key header instead:

ChatGPT

Open ChatGPT → Settings → Apps & Connectors, enable Developer mode (Plus/Pro/Enterprise), click Add connector with the Minimo MCP URL, set authentication to OAuth and click Authorize in the Minimo window.

Try it

Paste this into your connected agent. It only reads, and proves the connection end to end:
From there, Mo’s tools cover the full workspace: search and upsert contacts, build segments, create and send email / WhatsApp templates and campaigns, create, inspect and edit automations (performance included), check connection status (sender domain, database sync, WhatsApp), read, search and answer the inbox (WhatsApp and email conversations), and even query Minimo’s own docs, so the agent can answer “how does Minimo work?” without leaving the chat.

Edit an automation from your agent

Beyond creating automations from a prompt (minimo_automation_create-from-prompt), an agent can also fix an existing flow without rebuilding it:
  • minimo_automation_get reads the full graph: nodes (trigger, waits, condition rules with their ids, emails), edges, and run mode.
  • minimo_automation_edit-graph edits the graph of a disabled automation (drafts, or paused flows): change a Condition rule, swap the two branches of a condition, rewire an edge, insert or remove a node. Operations apply all together (an invalid batch changes nothing) and every edit is recorded in the account audit (visible under Logs). Active automations are refused: pause first, edit, review, re-enable.
  • The emails inside a flow are edited with the template tools (minimo_email_edit, minimo_template_set-subject, set-sender, set-category, …) using scope automation.
Boolean conditions: empty ≠ false. A condition like confirmed is false matches only contacts whose field is explicitly false. Contacts whose field is still empty do not match (so “send X to those who have NOT confirmed” would reach nobody on a fresh field). Model “not true” as: condition is true on the branch that does nothing (skip), action on the other branch, or use the group (is empty OR is false). The create and edit tools detect this trap and return a warning with your real contact counts.

Work your inbox from your agent

The agent can read and answer the conversations of your inbox, one thread per contact with every channel together:
  • minimo_inbox_list-threads lists threads with the inbox filters (open, unread, needs attention, assigned to me) and the tab counters; minimo_inbox_search-threads finds threads by what was written in them.
  • minimo_inbox_get-thread reads a thread across channels. It never marks it as read.
  • minimo_inbox_update-thread marks read or unread, closes, snoozes, assigns or pins; minimo_inbox_set-ai turns the AI off or on for one conversation.
  • minimo_inbox_reply answers by WhatsApp (only inside the 24-hour window) or email (same email thread), as you. It works in two steps: without confirm it returns a preview and sends nothing; it sends only with confirm: true, after your OK.
Full walkthrough: Triage your inbox with an AI agent.

What your agent learns on connect

When your agent connects, Minimo sends it short server instructions: what Minimo is, what it can do in your workspace, and the rules it must follow. Your agent doesn’t need a custom prompt to get started. The rules:
  • It answers in your language. Write in Italian and it replies in Italian, even though the tools and these docs are in English.
  • Nothing reaches real contacts without your OK. Automations and campaigns it creates are disabled drafts: it shows you what it built and activates, sends or schedules only after you say so. Tools that send real messages also require an explicit confirm.
  • Test sends go to you. minimo_email_send-test sends only to your own address, never to real contacts.
  • It reads your data first. Before building an automation it checks the database connection and the schema analysis, and turns values that live in other tables into dynamic fields instead of saying the data is missing.
  • Unsubscribe requests are honoured. If a contact asks to stop receiving marketing, the agent calls minimo_contact_opt-out. It applies your company’s opt-out scope, just like the Opt Out API, and never blocks transactional messages.
  • New tools need a new chat. The tool list is loaded when a chat starts: if a tool Minimo just released is missing, open a new chat (no need to reconnect).
To find out what else Minimo can do, the agent calls minimo_docs_guide with no arguments. It gets the index of this documentation and can then read any page.
Want to give your agent the full picture from the first message? In the app, Connect your AI agent (onboarding) and Copy prompt (Home, and the “Use Minimo AI everywhere” card) copy a ready onboarding prompt with your key: what Minimo is, how to connect, these rules, the main guides and a few first requests. Paste it into any AI.

Troubleshooting

  • 401 Unauthorized: the key is missing the mcp:invoke permission, expired, or malformed. Mint a fresh one from the dashboard card.
  • Connector shows no tools: make sure the URL is exactly https://api.minimo.it/mcp (no /v1 prefix) and the transport is HTTP (not SSE).
  • Wrong workspace: a key belongs to one workspace, the one it was created in. Ask the agent which workspace it’s connected to, or reconnect from Settings → Mo & MCP.

Next step

AI Prompts: ready-made prompts for AI coding tools.