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 pages. 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.

On older Codex versions without codex mcp add, add this to ~/.codex/config.toml instead, then run the login command:

[mcp_servers.cimanote]
url = "https://mcp.cimanote.com"

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

Open Cursor Settings, then MCP, and choose Add new MCP server - or add this to .cursor/mcp.json (per project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "cimanote": { "url": "https://mcp.cimanote.com" }
  }
}

Cursor opens the Cimanote sign-in the first time it connects.

VS Code (Copilot agent mode)

Add this to .vscode/mcp.json in your workspace (or use the MCP: Add Server command):

{
  "servers": {
    "cimanote": { "type": "http", "url": "https://mcp.cimanote.com" }
  }
}

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json. Note Windsurf uses serverUrl, not url:

{
  "mcpServers": {
    "cimanote": { "serverUrl": "https://mcp.cimanote.com" }
  }
}

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.

If a client only supports local (STDIO) servers, bridge it with mcp-remote:

{
  "mcpServers": {
    "cimanote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.cimanote.com"]
    }
  }
}

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 Knowledge 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.
  • The assistant acts as you and sees only your account's notes - the same permissions the app itself enforces, nothing broader.
  • Write actions (creating, editing, tagging, trashing) are marked so AI clients ask before running them. Review those confirmations rather than auto-approving, especially for edits that replace a note's body.
  • 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: reads are limited to 120 requests per minute and writes to 30 per minute, per account. Heavy agent workloads that hit the cap get a clear error and can simply retry - limits reset within a minute.

Bring your notes into the conversation

Included with Cimanote Pro

Start free