Browse the tools
Model Context Protocol (MCP)
Connect your AI assistant to Monica to find contacts, add people, and manage favourites through conversation.
Monica’s MCP server gives compatible assistants access to tools that work with your account.
https://my.monicahq.com/mcp
Set up Monica MCP
-
An assistant connects in one of two ways. If it supports OAuth, give it the server address and it sends you to Monica to sign in. Monica shows the name the assistant gives itself and the address it sends you back to, and connects it only when you choose Allow. No key is needed.
-
Otherwise, create an API key in Settings → Security and access → API keys. Under What will use this key, choose AI Assistant and give the key a recognisable name. Copy the key when it appears. Use a separate key for each assistant so you can revoke its access independently.
-
Every example on this page uses this address.
Set the MONICA_API_KEY environment variable to your Monica API key before starting Claude Code.
Add this configuration to your project’s .mcp.json. If the file already contains servers, add monica to the existing mcpServers object.
Start Claude Code from that environment, approve the project’s MCP configuration when prompted, and use /mcp to check the connection.
Make MONICA_API_KEY available in Cursor’s environment, then add this configuration to ~/.cursor/mcp.json.
Cursor reads the variable as ${env:MONICA_API_KEY}, with the env: prefix. Restart Cursor after changing its environment, then check that Monica appears in its MCP settings.
Set MONICA_API_KEY in the environment where you run Codex, then run:
Or add the server to ~/.codex/config.toml:
Restart Codex after configuration. If you use the desktop app, make sure the variable is available to the app’s process, not only to a terminal.
Run MCP: Open User Configuration from the Command Palette and add:
Start the server and enter your API key when prompted. VS Code stores it securely.
Not available in Agent Host
VS Code does not forward a server that asks for input to Agent Host sessions, so this configuration does not reach them.
Add a custom connector with the server address below. Claude opens Monica in your browser: sign in if you are asked to, check the name and the address on the screen, and choose Allow. No API key is needed.
Add a custom connector with the server address below and choose OAuth as its authentication. ChatGPT opens Monica in your browser: sign in if you are asked to, check the name and the address on the screen, and choose Allow. Whether custom connectors are offered depends on your ChatGPT plan and settings.
Use a client that supports remote HTTP MCP servers. If it supports OAuth, give it the server address alone and allow it when Monica asks. Otherwise, send an API key in a header:
Check your connection
Ask your assistant:
- “List my Monica vaults.” Confirm that the returned vaults belong to your account.
- “Find Alice in my Personal vault.” An empty result is fine. What matters is that the call succeeds against the right account.
Manage access
-
Your assistant acts as you, through its API key or its OAuth connection. Changes made through MCP are recorded in Settings → Logs, under the assistant’s name.
-
To disconnect an assistant connected through OAuth, choose Disconnect beside it in Settings → Security and access → Connected assistants. To disconnect one using a key, revoke its key in Settings → Security and access → API keys. Either takes effect at once.
Your assistant can access all your vaults
Your assistant can use every tool in every vault in your account, whether it connects with a key or through OAuth. Choosing “AI Assistant” when creating an API key only labels the key—it does not limit what your assistant can access or change.
Edit a template
A template changes through a draft. Its sections and fields can only change on a draft version, and nothing reaches the records it describes until the draft is published. Deleting a draft throws its changes away.
A field can come back with a new id when its section had to be drafted first. Use the id the tool returns.
Asked to add a Hobbies section with a text field and a date field, an assistant calls:
list-templates, to find the template.create-template-draft, to open a draft and learn its version number.add-template-sectionwith the name Hobbies, which returns the id of the new section.create-template-fieldtwice: a text field named Hobby, then a date field named Started.get-template-version, to check the draft.publish-template-version, with a note saying what changed.
Troubleshooting
- The assistant is refused
- With a key, the key is wrong or revoked: create a new one in Settings → Security and access → API keys and update your configuration. With OAuth, the assistant was disconnected or its access expired: remove the connector, add it again, and choose Allow.
- The server cannot be reached
- Check that the address ends in
/mcpand that your instance is reachable from the machine running the assistant. - The key is empty
- The assistant cannot see
MONICA_API_KEY. Set it in the environment the assistant starts from, then restart it. Desktop apps often do not read your terminal’s variables. - Too many requests
- The assistant reached the limit of 60 requests a minute for its key or its connection. Wait a minute and ask again.