Claude Code Playbooks MCP Server
Search the library of 1,290 playbooks and install CLAUDE.md templates and Skills without leaving your AI app. The server is free, read-only and needs no account.
Server URL
https://www.claudecodehq.com/api/mcpRemote MCP server over Streamable HTTP. Authentication: none.
What it does
The server gives your AI app three tools: one to search the playbook library, one to fetch a playbook with its full template, and one to list the 34 categories. Ask for help with a task, and the app can find a matching playbook and set it up for you. Claude Code saves the template into your project. In a chat app, you get the template to copy along with where to save it.
It serves the same playbooks and search ranking as this website, the JSON API and the ccplaybooks CLI.
Connect it
Claude (web, desktop and mobile)
- Open Settings → Connectors and choose Add custom connector.
- Name it Claude Code Playbooks and paste the server URL above. Leave the OAuth fields empty.
- Turn the connector on in a chat from the tools menu, then ask for a playbook (examples below).
On Team and Enterprise plans, an Owner may need to add the connector for the organization first.
Claude Code
Run this once in your terminal:
claude mcp add --transport http claude-code-playbooks https://www.claudecodehq.com/api/mcpAdd --scope user to make it available in every project. Run /mcp inside Claude Code to check that it is connected.
Other MCP clients
Any client that supports remote MCP servers over Streamable HTTP can connect to the server URL with no authentication. A JSON config usually looks like this:
{
"mcpServers": {
"claude-code-playbooks": {
"type": "http",
"url": "https://www.claudecodehq.com/api/mcp"
}
}
}Tools
All three tools only read the public playbook library. They are marked readOnlyHint: true and destructiveHint: false, and they never change anything on the server or in your accounts.
search_playbooks
Search playbooksRead-onlyFinds playbooks by keyword, category or difficulty.
Parameters
query(string, optional, up to 200 characters): One to three keywords, such as "invoice automation". Every word has to match a playbook title, tag or description. Leave it out to list the newest playbooks.category(string, optional): A category id from list_categories.difficulty(string, optional): beginner, intermediate or advanced.limit(integer 1 to 25, default 10): How many results to return.
Returns
The total number of matches and, for each result, its slug, title, description, category, difficulty, setup time and page URL, ranked by relevance. If nothing matches, it suggests trying broader words.
get_playbook
Get a playbookRead-onlyGets one playbook with its full template.
Parameters
slug(string, required): The playbook slug from search_playbooks, such as "invoice-automation".
Returns
What the playbook does, who it is for, its author and source, license details where they apply, and the full template. It also says where to save the template: CLAUDE.md in the project folder, or .claude/skills/<name>/SKILL.md for a Skill. It includes an attribution comment to keep at the top of the saved file. An unknown slug returns an error with up to three similar slugs.
list_categories
List categoriesRead-onlyLists the playbook categories, so searches can be narrowed to one.
Parameters
None.
Returns
Each category's id, name, description and number of playbooks.
Example prompts
- "Find a playbook for organizing my Downloads folder and set it up in this project."
- "Is there a playbook for reviewing contracts? Show me the best two and what each one does."
- "What categories of playbooks are there? List the beginner ones for marketing."
- "Install the invoice-automation playbook as my CLAUDE.md."
How installing works
A remote server can't reach your computer, so the server never writes files itself. It sends the template and the path to save it at, and your AI app does the rest:
- Claude Code and other apps that can edit files save it to the right place. If a CLAUDE.md already exists, the server tells the app to ask you before replacing it; appending is usually the safer choice.
- Chat apps show the template in a code block, say where it belongs, and link the playbook page so you can download it.
Every template starts with an attribution comment naming the playbook and its original source. Some templates carry a license notice that has to stay with every copy. See Licensing & Attribution.
Privacy and data
- No account, no sign-in, no API key.
- The server only receives the search words, filters or slug your AI app sends, plus standard request details such as IP address and time. It can't see your files, your conversation or your accounts.
- Search terms aren't saved, profiled or used for advertising, and tool responses contain no ads or affiliate offers.
Full details are in the Privacy Policy.
Limits
- Searches return up to 25 results at a time.
- The server only covers the playbooks published on this site.
- Nothing is kept between requests, so there are no saved searches or favorites.
Troubleshooting
- Opening the URL in a browser shows an error. That's expected: the URL is for MCP clients, not browsers. Add it to your AI app instead.
- A search finds nothing. Every word in the query has to match, so try one or two broader words, or ask for the list of categories.
- Claude doesn't use the tools. Check that the connector is turned on for the chat, or run
/mcpin Claude Code, then name the library in your prompt: "Search Claude Code Playbooks for…".
Support
For help or to report a problem, see Support or open an issue on GitHub.