--- title: "MCP server for your saved articles, transcripts, and notes | Keep" description: "Connect Claude, Codex, Cursor, and other MCP clients to Keep. Agents search the articles, transcripts, and notes you saved, quote the source, and update your notes with attribution." canonical: "https://keep.md/features/ai-library" language: "en" --- # Give your AI agents the things you actually read. Keep is a Markdown library with an MCP server and a CLI. Connect Claude, Codex, Cursor, or another client, and it can search what you saved, open the source, and add to your notes with the change attributed to it. [Create a free account](https://app.keep.md/signup?utm_source=keep.md&utm_medium=content&utm_campaign=features-ai-library) Full-content saves, search, and sources are included with Personal for $10/month. Any account can connect an MCP client. 01. ## Ask about what you saved. Get the source back. A connected client searches notes and saved items together, reads the relevant slice, and can append to a note. Every write shows up in the note’s history with the client’s name. **Keep MCP:** Connected · items.read, notes.write. Claude Code, Approved in the browser once. ### Example questions #### what have I saved about API rate limits? **Keep tools:** search\_context, get\_item Three items. A talk transcript from Northwind Engineering argues rate limits are a contract and should ship with headers. A saved thread covers per-key limits with burst allowances. Your own note from July lists the numbers you considered for the public API. #### add the header advice to my API design note with the source **Keep tools:** get\_note, update\_note Appended a short section to “API design decisions” quoting the transcript at 18:42, with a link to the saved video. The note history shows this change from Claude Code. #### save this page so I can read it later: harbor.example/blog/backpressure **Keep tools:** save\_item Saved “Backpressure without drama” as Markdown. It is in your Feed with the full article text and will show up in search from now on. [Read the MCP docs](https://keep.md/docs/mcp) 02. ## Connect over MCP, or use the CLI. Point your client at https://keep.md/mcp and approve access in the browser once. The CLI installs with npm and works in terminals and scripts. 1. **Add the Keep MCP server.** Add https://keep.md/mcp to Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Pi, VS Code, or another remote MCP client. 2. **Approve access once.** The first connection opens your browser to sign in and approve the scopes the client asked for. Access renews in the background after that. 3. **Ask, save, and write.** Your client can search your library, read items and notes, save URLs as Markdown, and append to notes. Or install the CLI with npm i -g keep. [Read the setup steps](https://keep.md/docs/mcp) 03. ## Context you chose, not the whole internet. Agents answer from the articles, transcripts, threads, and notes you decided were worth keeping, and they can point to where each answer came from. 1. ### Writing with your own research Ask for what you saved on a topic. The agent quotes the saved page or transcript and links the source into your draft. 2. ### Coding with the docs you trust Save the reference pages, changelogs, and talks you rely on. A coding agent searches them instead of guessing from training data. 3. ### Notes that agents help maintain Let an agent append findings to a Markdown note as you work. The note history records each change and which client made it. 04. ## Every answer points back to a saved source. Search results stay short until the client opens a specific note or item. Writes return a receipt, and note history shows which client changed what. [**Search by words or meaning**search\_context and search\_items find saved items and notes by keyword and semantic similarity.](https://keep.md/docs/search)[**Attributed note changes**A trusted client’s name appears in note history. Appends never overwrite a newer change.](https://keep.md/docs/agents)[**The same library from a terminal**keep search, keep get, keep save, and keep notes work in scripts and agent sessions without MCP.](https://keep.md/docs/cli)[**Scoped access you can revoke**Each connection receives only the scopes you approved. Remove the server from your client when it no longer needs access.](https://keep.md/docs/mcp#access-requested-by-mcp) 05. ## Questions about connecting AI clients. ### Which AI clients work with Keep? Any remote MCP client. Keep documents setup for Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Pi, and VS Code. Terminal agents and scripts can use the CLI instead. ### What can a connected client do? Search notes and saved items together, read an item or note, save a URL as an Item with extracted Markdown, create and update notes, attach items to notes, and manage sources. Account limits still apply. ### Will an agent overwrite my notes? Append mode adds to the latest revision and preserves concurrent appends. Replacing content requires the expected revision, so a stale client cannot overwrite a newer change. The client’s name appears in note history. ### How does sign-in work? The first connection opens a browser window to sign in and approve the requested scopes. Access renews in the background until you disconnect, revoke it, or reset the client. ### Do reads use credits? No. Reads do not use note credits. Creating a note uses one credit; editing an existing note does not use another. ### Do I need Personal to connect an AI client? You can connect a client on a free Starter account and read what you have saved. Personal, at $10/month, adds full-content Markdown, search across your library, and sources, which is what makes the library useful to an agent. 06. ## Related ways to work with agents. [**Guide: Claude and your saved library**Connect Claude over MCP and ask it about the pages you saved.](https://keep.md/blog/claude-mcp-saved-library)[**Developers**API keys, webhooks, and change polling for your own apps and scripts.](https://keep.md/developers) ## Build the library your agents work from. Create a free account and connect a client. Add Personal for $10/month when you want full-content saves, search, and sources. [Create a free account](https://app.keep.md/signup?utm_source=keep.md&utm_medium=content&utm_campaign=features-ai-library) [Read the MCP docs](https://keep.md/docs/mcp)