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.

  1. You paste config once: includes your personal token and runs npx @mykeepai/mcp automatically.
  2. You ask in plain English: “What did I save about React?”, “Save this link”, “How many items do I have?”
  3. The AI calls MyKeep tools: search, save, list workspaces, usage, etc. You see the answer in chat; no manual API calls.
  4. 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 logout

    Aliases: mykeepai out

    Remove saved token from this computer

  • mykeepai whoami

    Aliases: 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 usage

    Aliases: 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 workspaces

    List workspaces (JSON)

  • mykeepai tags

    List tags (JSON)

  • mykeepai version

    Aliases: mykeepai --version, mykeepai -v

    Print CLI version

  • mykeepai mcp

    Start the MCP server (used by npx config; not for daily use)

  • mykeepai --help

    Aliases: 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.