Connect Keep to Claude, Cursor, and other AI tools
The Keep MCP server lets AI tools search notes and saved items together. They can continue a handoff, record an idea or decision, or attach a saved item as evidence. It works with any client that supports the Model Context Protocol, including Claude Code, Cursor, VS Code, and Codex.
Point your MCP client at this endpoint:
https://keep.md/mcp
The first time your AI client connects, it will open a browser window to sign in and authorize access to your account.
Client setup
Select the client you want to use the keep MCP with for instructions on how to install it.
Run this in your terminal to add keep to Claude Code.
claude mcp add --transport http keep https://keep.md/mcp
What connected AI can do
Once connected, your AI tool can search your whole Keep library, read and update notes, attach saved items, work through your inbox, and manage sources. Search results stay short until it opens a specific note or item. The same limits from your plan still apply.
Note tools return a webUrl that opens the note in Keep, plus an apiUrl for clients that need the raw note response.
| tool | description |
|---|---|
| search_context | Search notes and saved items together |
| get_note | Read a note with optional sources and recent history |
| create_note | Create a Markdown note |
| update_note | Append to or replace a note using its revision number |
| attach_item | Attach an item or highlight to a note |
| save_item | Save a new item from a URL |
| search_items | Search items by keyword and semantic similarity |
| list_items | List saved items with optional filters |
| get_item | Get an Item with connected Notes when permitted and optional content |
| list_item_highlights | List highlights attached to an item |
| get_highlight | Get a single highlight by id |
| update_item | Update title, notes, tags, or status of an item |
| whoami | Get the current account and plan details |
| list_sources | List your content sources and subscriptions |
| add_source | Add a content source like RSS, YouTube, X, or email |
| remove_source | Remove a source |
| get_stats | Get usage stats for your account |
| list_inbox | Get unprocessed items from the inbox |
| list_item_changes | List item change events for delta sync |
| mark_done | Mark inbox items as processed so they leave the inbox |
Need something different?
If you want to integrate Keep into your own app or script, check the API or CLI instead. To keep another system in sync, use the API keys with /items/changes for polling or Webhooks for push delivery.