Keep My Prompts — MCP server

Read your saved Keep My Prompts library from Claude Code, Claude Desktop, Cursor, or any other MCP client. Ask for a prompt by name and the model fetches it; no copy-pasting from a browser tab.

Read-only: this server can list and read your prompts. It cannot create, edit or delete anything.

Requirements

• Node.js 20 or newer (node --version)
• A Keep My Prompts account on a plan that includes MCP access: Pro, Ultimate, or any Team plan
• An API key from Keep My Prompts → Settings → MCP

Install

claude mcp add keepmyprompts -e KMP_API_KEY=kmp_live_... -- npx -y github:simopet/keepmyprompts-mcp#v0.2.0

Always install from a version tag (#v0.2.0), never from the bare repo name. Without a tag your client silently picks up whatever landed on the default branch since you installed, with no way to go back.

For Claude Desktop or Cursor, add this to the MCP servers section of the client's config file instead:

{
  "mcpServers": {
    "keepmyprompts": {
      "command": "npx",
      "args": ["-y", "github:simopet/keepmyprompts-mcp#v0.2.0"],
      "env": { "KMP_API_KEY": "kmp_live_..." }
    }
  }
}

Other MCP clients

Any client that can run local (stdio) MCP servers works: VS Code with GitHub Copilot, Windsurf, Zed, Cline, Continue, Gemini CLI, Codex CLI, and others. The configuration is the same three values everywhere — command: "npx", the args above, and KMP_API_KEY in the environment; only the name and location of the config file differ, so check your client's MCP documentation.

What does not work: browser-only hosts, such as claude.ai on the web or ChatGPT on the web, connect only to remote MCP servers. This server is local by design — it runs on your machine and nowhere else.

Install from a local clone

npx re-resolves the package each time your client starts a session. If you'd rather pay that cost once, clone and point the client at the built file:

git clone https://github.com/simopet/keepmyprompts-mcp.git
cd keepmyprompts-mcp
npm install          # also builds, via the prepare script

Then use "command": "node" with "args": ["/absolute/path/to/keepmyprompts-mcp/dist/index.js"].

Configuration

Variable	Required	Default	Notes
KMP_API_KEY	yes	—	Your key, starting kmp_live_. The server exits immediately without it.
KMP_API_URL	no	https://www.keepmyprompts.com	Keep the www.; the bare domain redirects and the request is refused rather than silently followed.

The key is read from the environment and sent as a bearer token over HTTPS. It is never written to disk or logged.

Tools

Tool	Arguments	What it does
list_prompts	category (optional)	Titles, categories and your own notes for each saved prompt. Not the prompt text — that keeps the list cheap, and the notes are what let the model tell two similar prompts apart. Long notes are shortened here and shown in full by get_prompt.
get_prompt	id	Full text and full notes of one prompt.
list_categories	—	Your categories with a count each, for narrowing a large library.

Write useful notes. The notes field is what the model reads when deciding which of your prompts fits the task. "For cold outreach to agencies, keep it under 120 words" earns its keep; an empty notes field leaves the model guessing from the title alone.

Ask in plain language — "use my follow-up email prompt", "what prompts do I have for code review" — and the model picks the tool.

Troubleshooting

What you see	What it means
KMP_API_KEY is not set	The client started the server without the variable. Check the env block in your MCP config.
API key is missing, invalid or revoked	The key was deleted or regenerated. Create a new one in Settings.
plan does not include MCP access	The account is on Free, or a paid plan lapsed. MCP is on Pro, Ultimate and Team.
Too many requests	More than 60 calls in a minute from one key. It clears within the minute.
redirected the request (HTTP 301)	KMP_API_URL is missing the www..
bot-protection challenge	Our problem, not yours — please open an issue.
The tools never appear in the client	Node is older than 20, or the client cached a failed start. Check node --version, then fully restart the client.

Installation problems are worth reporting even when you work around them: open an issue.

How it works

Your prompts are encrypted at rest. This server never holds the encryption key — it makes authenticated HTTPS requests to /api/mcp/v1/*, and the Keep My Prompts API decrypts server-side exactly as it does for the web app. The server runs locally on your machine over stdio and talks to nothing except the API.

Licence

MIT — see LICENSE.