claude-prompts-mcp

The portable workflow layer beside your AI coding harness.

Quick Start · What You Get · Compose Workflows · Run Anywhere · Docs

What your AI client gives you — and what this server adds

Is this for me?

• Use this if you write the same prompts repeatedly, run multi-step workflows, or want to share reusable prompts with a team.
• Skip if your client's built-in /commands already handle what you need, or you're looking for a no-code prompt library.
• Works with Claude Code, Claude Desktop, Cursor, VS Code, OpenCode, Gemini CLI, Codex, Windsurf, and Zed. Hook coverage differs by client; the setup table lists it.

Quick Start

Claude Code (Recommended)

/plugin marketplace add minipuft/minipuft-plugins  # first time only
/plugin install claude-prompts@minipuft
>>tech_evaluation_chain library:'zod' context:'API validation'

Codex (Experimental)

Turn on hooks in ~/.codex/config.toml, then install the plugin:

[features]
hooks = true

codex plugin marketplace add https://github.com/minipuft/minipuft-plugins.git
codex plugin add codex-prompts@minipuft

Restart Codex, run /hooks to review and trust the plugin hooks, then try the same >>tech_evaluation_chain command. Needs Codex CLI 0.117 or later; not available on Windows (requirements).

git clone https://github.com/minipuft/claude-prompts-mcp ~/Applications/claude-prompts-mcp
cd ~/Applications/claude-prompts-mcp/server && npm install && npm run build
claude --plugin-dir ~/Applications/claude-prompts-mcp

Edit hooks/prompts → restart Claude Code. Edit TypeScript → rebuild first.

Every client

Hooks are what make >>, -->, and :: work in conversation; "MCP tools only" means the three MCP tools without them. See With Hooks. Config locations and --client presets: Client Capabilities Reference.

More Client Setups

Option A: GitHub Release (recommended): download claude-prompts-{version}.mcpb from Releases and drag it into Claude Desktop Settings → MCP Servers. The .mcpb bundle is self-contained (~5MB); no npm required.

Option B: NPX (auto-updates): add this to your config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "claude-prompts": {
      "command": "npx",
      "args": ["-y", "claude-prompts@latest", "--client", "claude-code"]
    }
  }
}

Restart Claude Desktop and test: >>research_chain topic:'remote team policies'

npm install -g opencode-prompts && opencode-prompts install

For MCP tools without hooks, use the manual config in the Client Integration Guide.

gemini extensions install https://github.com/minipuft/gemini-prompts

For MCP tools without hooks, use the manual config in the Client Integration Guide.

Add the server to ~/.cursor/mcp.json. The Client Integration Guide has the JSON example and the --client preset.

Add the server through VS Code's MCP configuration. The Client Integration Guide has the JSON example and the --client preset.

Add the server to ~/.codeium/windsurf/mcp_config.json. The Client Integration Guide has the JSON example and the --client preset.

Add the server under the mcp key of ~/.config/zed/settings.json. The Client Integration Guide has the JSON example and the --client preset.

From source (developers):

git clone https://github.com/minipuft/claude-prompts-mcp.git
cd claude-prompts-mcp/server && npm install && npm run build && npm test

Point your MCP config to server/dist/index.js. Transport: --transport=stdio (default) or --transport=streamable-http.

Custom resources: --init=~/my-prompts scaffolds a starter workspace: three example prompts plus config.jsonc. Edit them (YAML schema), or have your AI author new prompts, gates, and frameworks via resource_manager. Point MCP_RESOURCES_PATH at an existing workspace if you already have one in the right shape. Resources that belong to one repository go in .claude-prompts/ at its root (cpm init --project scaffolds it) and load above your workspace over STDIO. See Custom Resources Guide.

What You Get

Four primitives you author, version, and compose. The bundled set ships 52 prompts across 9 categories — a starting library, not the ceiling: your AI writes new prompts and chains through resource_manager as it works, so the set grows around what you actually do. All hot-reloadable, all versioned with rollback.

| Primitive | Symbol | What it is