How do I install the mcp playbook server mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GITHUB_PERSONAL_ACCESS_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Playbook Server MCP Server

A Model Context Protocol (MCP) server for managing project documentation and saving conversation logs within a user-specified target project

Local serverstdioTypeScript

What is the MCP Playbook Server MCP Server?

A Model Context Protocol (MCP) server for managing project documentation and saving conversation logs within a user-specified target project directory.

What it actually does

This mcp-playbook server is a self-contained Node.js/TypeScript application that provides a set of tools accessible via the Model Context Protocol (MCP). Its primary functions are to help LLMs structure documentation within a designated project directory and to save/upload conversation histories. Unlike tools that might rely on external commander or github environments, this server implements file system operations and GitHub API interactions directly using Node.js's built-in modules (fs, path, https) and libraries like node-fetch.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
init_playbook	Provides an instruction to the LLM about the purpose of the mcp-playbook server, which is to facilitate local project documentation and enable partial replication of documentation and chat logs for an AI-powered playbook
create_spec	Creates or overwrites a new specification file (e.g., PRD, RFC, architectural planning) in the docs/specs/ directory of the target project. Specification files will be named following a spec-name.md convention with seque
create_adr	Creates or overwrites a new Architectural Decision Record (ADR) file in the docs/adr/ directory of the target project. ADR files will be named following an adr-name.md convention with sequence numbering.
create_changelog	Creates a new, detailed, and user-facing changelog entry file in the docs/changelog/ directory of the target project. Each changelog entry will be a separate file named following a changelog-entry.md convention with sequ
distill_project_runbook	Creates or updates the central docs/runbook.md file within the target project. The LLM is responsible for analyzing existing project documents (ADRs, specs, etc.) and the current docs/runbook.md (if it exists), then synt
save_and_upload_chat_log	Captures the current conversation history, saves it as a markdown file in the .chat/ directory of the target project, and uploads it to the dwarvesf/prompt-log GitHub repository. Requires a user ID for organization.
search_runbook	Fuzzy search for keywords in the dwarvesf/runbook GitHub repository. If keyword has spaces, searches exact phrase OR individual words. Returns top 5 matches with full content & total count.
search_prompts	Fuzzy search for keywords in the dwarvesf/prompt-db GitHub repository (excluding the .synced_prompts/ folder).
suggest_runbook	Creates or updates a Pull Request in the dwarvesf/runbook repository with a new runbook entry.
sync_prompt	Syncs an LLM prompt to the dwarvesf/prompt-db GitHub repository.
think	Use the tool to think about something. It will not obtain new information or make any changes to the repository, but just log the thought. Use it when complex reasoning or brainstorming is needed.

How to install the MCP Playbook Server MCP Server

{
  "mcpServers": {
    "mcp-playbook": {
      "command": "npx",
      "args": ["-y", "@dwarvesf/mcp-playbook@latest"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
GITHUB_PERSONAL_ACCESS_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use MCP Playbook Server to init playbook.”
“Use MCP Playbook Server to create spec.”
“Use MCP Playbook Server to create adr.”

Frequently asked questions

A Model Context Protocol (MCP) server for managing project documentation and saving conversation logs within a user-specified target project directory. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.