Home/Docs/MCP server

MCP server

The Keep MCP server lets your AI tools search, read, and save your items. It works with any client that supports the Model Context Protocol — Claude Code, Cursor, VS Code, and many more.

Point your MCP client at this endpoint:

https://keep.md/mcp

The first time your agent 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.

Claude Code MCP docs

Run this in your terminal to add keep to Claude Code.

claude mcp add --transport http keep https://keep.md/mcp

What your agent can do

Once connected, your agent can list items, search items, read item metadata and extracted content, save new URLs, update item metadata, work through your inbox, and manage sources. The same limits from your plan still apply.

tooldescription
save_itemSave a new item from a URL
search_itemsSearch items by keyword and semantic similarity
list_itemsList saved items with optional filters
get_itemGet a single item by id with optional content
update_itemUpdate title, notes, tags, or status of an item
whoamiGet the current account and plan details
list_sourcesList your content sources and subscriptions
add_sourceAdd a content source like RSS, YouTube, X, or email
remove_sourceRemove a source
get_statsGet usage stats for your account
list_inboxGet unprocessed items from the inbox
mark_doneMark 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.