Setup guide

Connect Cimanote to your AI

Cimanote has a built-in MCP server. MCP (Model Context Protocol) is the open standard AI assistants use to connect to your tools, and it works with Claude, ChatGPT, Cursor, and most AI agents. Connect once and your assistant can search, read, and create your notes, and read your Knowledge Engine wiki. Requires Cimanote Pro or an active trial.

Your connector address: https://mcp.cimanote.com

Claude (web, desktop, mobile)

  1. Open Claude Settings, then Connectors, and choose "Add custom connector".
  2. Paste https://mcp.cimanote.com and click Add, then Connect.
  3. A browser window opens on the Cimanote sign-in. Sign in, review what access is being requested, and approve. That is it - the connector works across Claude web, desktop, and mobile once connected.

Claude Code

One command:

claude mcp add --transport http cimanote https://mcp.cimanote.com

Then run /mcp inside Claude Code to sign in. Your notes become available to every coding session.

ChatGPT

ChatGPT keeps custom MCP connectors behind a Developer mode switch, and they need a paid plan (Plus or Pro; on Business and Enterprise an admin must allow them).

  1. On ChatGPT web (chatgpt.com, not the mobile app), open Settings, then Connectors.
  2. Scroll to the very bottom of the Connectors screen, open Advanced settings, and switch on Developer mode.
  3. Back on the Connectors screen, choose Create (or Add custom connector). Name it Cimanote, paste https://mcp.cimanote.com as the MCP server URL, and pick OAuth for authentication.
  4. ChatGPT walks you through the same Cimanote sign-in and approval step.

If Advanced settings is not visible at the bottom of the Connectors screen, your account has not received the Developer mode rollout yet - OpenAI enables it gradually, and on Business and Enterprise plans an admin must allow it first.

Codex (OpenAI's coding agent)

Two commands in your terminal:

codex mcp add cimanote --url https://mcp.cimanote.com

codex mcp login cimanote

The login command opens the same Cimanote sign-in and approval flow. Works in the Codex CLI and the Codex IDE extensions, which share the same configuration.

Grok

  1. Go to grok.com/connectors and choose New Connector, then Custom.
  2. Enter https://mcp.cimanote.com as the MCP server URL.
  3. Complete the Cimanote sign-in and approval when prompted.

Cursor and other MCP clients

Add a remote MCP server with the URL https://mcp.cimanote.com (transport: HTTP). The client will prompt you to sign in to Cimanote the first time it connects. Any MCP-compatible tool - agents, IDEs, automation platforms - works the same way.

Things to try

  • "What did I write about [any topic] in my notes?"
  • "Save a note titled Ideas with the key points from this conversation."
  • "Add a task list for tomorrow to my note called Weekly Plan."
  • "What notebooks do I have, and which one has the most notes?"
  • "Read my wiki page about [a project or person] and summarize what I know."
  • "Tag my untagged notes from this week based on their content."

Access and control

  • You approve access with your own Cimanote login on a consent screen. There are no API keys to copy or store.
  • Every connected app is listed in the Cimanote app under Settings, then Connections, each with a Revoke button that cuts access immediately.
  • AI assistants can never permanently delete your notes. Removal only ever moves a note to your Trash, where it stays restorable for 30 days.
  • Notes shared for real-time collaboration cannot be edited through AI connections.
  • The toggle under Settings, then Pro Features ("Claude & AI Connections") pauses all AI access at once without disconnecting anything.

Troubleshooting

  • "Connection failed" during setup: remove the connector and add it again - authorization links are single-use and expire quickly. Make sure the browser window that opens is signed in to the Cimanote account you want to connect.
  • "Requires a Pro subscription or active trial": AI connections are a Pro feature. Access resumes instantly when you upgrade, with no need to reconnect.
  • Rate limits: heavy agent workloads can briefly hit per-minute limits. They reset within a minute.

Bring your notes into the conversation

Included with Cimanote Pro

Start free