Keep

An MCP server for your saved articles, transcripts, and notes.

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 accountSee an example

Full-content saves, search, and sources are included with Personal for $10/month. Any account can connect an MCP client.

01.

An example agent session and how it connects.

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

MCPlive session
Keep MCPConnected · items.read, notes.write

Claude Code · Approved in the browser once

Example session · Not a live connectionRead the MCP docs

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.

MCP serverFor AI clients

Add the hosted server to Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Pi, VS Code, or another MCP client. Your browser opens once so you can approve access.

No clients found

Run this command to add Keep to Claude Code.

claude mcp add --transport http keep https://keep.md/mcp
Read the MCP docs
Keep CLIFor terminals and scripts

# install the CLI

$ npm i -g keep

# authenticate this agent

$ keep login codex

→ Codex connected with read and write access

# search from this project

$ keep search "rate limits"

→ 1 note · 3 items

Read the CLI docs

03.

What people use it for: writing, coding, and maintaining notes.

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.

Search, attributed edits, CLI access, and revocable scopes.

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 meaningsearch_context and search_items find saved items and notes by keyword and semantic similarity.Attributed note changesA trusted client’s name appears in note history. Appends never overwrite a newer change.The same library from a terminalkeep search, keep get, keep save, and keep notes work in scripts and agent sessions without MCP.Scoped access you can revokeEach connection receives only the scopes you approved. Remove the server from your client when it no longer needs access.

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 features.

Guide: Claude and your saved libraryConnect Claude over MCP and ask it about the pages you saved.DevelopersAPI keys, webhooks, and change polling for your own apps and scripts.

Create a free account and connect your first agent.

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 accountRead the MCP docs