Connect AI
Use MyKeep from Cursor, Claude, and Codex
MyKeep MCP lets your AI assistant search your library and save links or notes while you work. Included with lifetime access, with no extra AI credits from MyKeep.
Sign in and choose a plan to use Connect AI. Paid subscribers can use the web app and mobile app.
1. Get your token
Generate a personal token in Settings. It only accesses your library.
2. Paste config
Copy the config for Cursor, Claude, or Codex. Paste once, restart the app.
3. Chat naturally
Ask in plain English: “Search MyKeep for…” or “Save this link to MyKeep.”
How MyKeep MCP works in practice
MCP is not a terminal command you type yourself. After you paste the config into Cursor, Claude Desktop, or Codex, your AI assistant connects to MyKeep in the background. When you chat. For example, “search MyKeep for amazon”. The app decides which MyKeep tool to call (usually mykeep_search) and returns your real library results into the conversation.
- You paste config once: includes your personal token and runs
npx @mykeepai/mcpautomatically. - You ask in plain English: “What did I save about React?”, “Save this link”, “How many items do I have?”
- The AI calls MyKeep tools: search, save, list workspaces, usage, etc. You see the answer in chat; no manual API calls.
- Your data stays yours: tools only read and write your MyKeep account. No extra MyKeep AI billing.
MCP vs terminal CLI
MCP = inside Cursor / Claude / Codex chat. Tool names like mykeep_usage are for the AI, not PowerShell.
CLI = PowerShell / Terminal. Use mykeepai usage or mykeepai s how many items directly.
All MCP tools (12)
Your AI calls these automatically when you chat. You do not type these in PowerShell unless you use the example prompts, or the matching mykeepai CLI commands below.
mykeep_search
Smart search — titles, notes, URLs, tags, AI tags, colors in photos, OCR text, and natural queries like “how many items” or “any photo”.
Params: q (required), limit?, type? (link | note | quote | image | video | document | voice | todo)
Try: “Search MyKeep for amazon links”
mykeep_search_keyword
Plain keyword search only — exact text match in titles, notes, and tags.
Params: q (required), limit?, type?
Try: “Keyword-search MyKeep for “react hooks””
mykeep_usage
Library usage — item count, limits, remaining slots, lifetime access status.
Params: (none)
Try: “How many items do I have in MyKeep?”
mykeep_get_item
Open one saved card by ID with full content and metadata.
Params: id (required), includeArticle? (fetch link article text)
Try: “Open MyKeep item abc-123 and show the full note”
mykeep_list_workspaces
List all workspaces you can save into.
Params: (none)
Try: “List my MyKeep workspaces”
mykeep_list_tags
List all tags in your library.
Params: (none)
Try: “List my MyKeep tags”
mykeep_save_link
Save a URL as a link card.
Params: url (required), title?, workspaceId?, tagIds?
Try: “Save https://example.com to MyKeep”
mykeep_save_text
Save a note, quote, voice file, or todo list.
Params: type (note | quote | voice | todo), content?, filePath?, todos?, workspaceId?, tagIds?
Try: “Save this as a MyKeep note: standup notes…”
mykeep_tag_item
Add tags by name to existing cards.
Params: itemIds[] (required), tags[] (required)
Try: “Tag these MyKeep items with “reading-list””
mykeep_import_url
Import an image, video, or document from a public HTTPS URL.
Params: url (required), type (image | video | document)
Try: “Import this image URL into MyKeep”
mykeep_list_plans
List your plans (lifetime access required). Scheduling is easiest in the app.
Params: (none)
Try: “List my MyKeep plans”
mykeep_schedule_plan_entry
Schedule an item on a plan (lifetime + existing plan required).
Params: planId, itemId, startsAt?, timezone?
Try: “Schedule this MyKeep item on my Work plan for tomorrow”
Try these prompts
- “Search MyKeep for amazon links”
- “How many items do I have in MyKeep?”
- “Search MyKeep for blue photos”
- “Save https://example.com to MyKeep”
- “Save this as a note in MyKeep: meeting summary…”
- “List my MyKeep workspaces”
- “What did I save about Next.js?”
All CLI commands: mykeepai --help
Run in PowerShell or Terminal after npm install -g @mykeepai/mcp. Token saved in ~/.mykeep/. Type mykeepai --help anytime for the full list.
One-time setup
npm install -g @mykeepai/mcp mykeepai login
Quick examples
mykeepai s amazon mykeepai s how many items mykeepai usage mykeepai save-link https://example.com mykeepai save-note "meeting notes" mykeepai workspaces mykeepai tags mykeepai whoami mykeepai --help
No global install
npx -p @mykeepai/mcp mykeepai login npx -p @mykeepai/mcp mykeepai s amazon npx -p @mykeepai/mcp mykeepai --help
mykeepai login [token]Aliases: mykeepai in
Save your API token once (paste when prompted if omitted)
mykeepai logoutAliases: mykeepai out
Remove saved token from this computer
mykeepai whoamiAliases: mykeepai status
Show saved login, token file path, and whether token is valid
mykeepai s <query>Aliases: mykeepai search <query>, mykeepai q <query>
Smart search — text, tags, colors, OCR, counts (“how many items”), browse (“any photo”)
mykeepai usageAliases: mykeepai mykeep_usage
Item count, limits, remaining slots, lifetime access (MCP: mykeep_usage)
mykeepai save-link <url>Save a URL as a link card
mykeepai save-note "text"Save a text note
mykeepai workspacesList workspaces (JSON)
mykeepai tagsList tags (JSON)
mykeepai versionAliases: mykeepai --version, mykeepai -v
Print CLI version
mykeepai mcpStart the MCP server (used by npx config; not for daily use)
mykeepai --helpAliases: mykeepai help, mykeepai -h
Show full command reference
mykeepai --token <token>Aliases: mykeepai -t <token>
Pass token for one command without saving (optional flag)
mykeepai --api-url <url>Override API URL (default https://www.mykeep.space)
FAQ
Who can use Connect AI?
MCP and CLI are included with lifetime access. Active subscribers can use the web app and mobile app. Upgrade on the pricing section, then open Settings → Connect AI to generate a token.
Does this cost extra?
No AI API charges from MyKeep. MCP only reads and writes your library. Your Cursor or Claude subscription is separate.
Is my token safe?
Treat it like a password. Do not share it or commit it to git. Revoke it anytime in Settings → Connect AI.
What do I need installed?
Node.js 18 or newer. When you paste the MCP config, npx downloads and runs @mykeepai/mcp automatically You do not need to clone the repo or run npm install yourself.
Is this a terminal CLI?
Yes. Run mykeepai login once, then use short commands like mykeepai search amazon. See the CLI section above. Cursor/Claude still use the MCP config with npx.
What is smart search?
Smart search is not only for colors. It matches across your whole library:
- Text: titles, note body, link URLs, domains, descriptions
- Tags: tags you added and auto-generated AI tags
- Photos: dominant colors (try
blue) and text inside images (OCR) - Natural questions: “how many items”, “any photo”, “how many notes”
Same behavior in the app search bar, mykeepai s …, and MCP mykeep_search.
Why did mykeep_usage fail in PowerShell?
mykeep_usage is an MCP tool name for Cursor/Claude. In the terminal use mykeepai usage or ask your AI “check my MyKeep usage”.
Where is Plan mode?
Scheduling and calendar plans live in the MyKeep app (Dashboard → Plans). MCP and CLI focus on search and save. Use the app for plan scheduling.
Will it work in ChatGPT’s website?
This setup works in desktop apps that support MCP (Cursor, Claude Desktop, Codex, and similar). Browser-only chat tools need a hosted connector, coming later.