Overview

@playbooks/mcp exposes Playbooks as MCP tools inside clients like Claude Code, Cursor, Codex, and VS Code.

It wraps the Playbooks CLI, so agents can use the same account, config, and project workflows from chat.

Prerequisites

  • Node
  • A Playbooks account
  • @playbooks/cli
  • An MCP client like Claude Code, Cursor, Codex, or VS Code

Description

The MCP server does not reimplement Playbooks logic. It translates MCP tool calls into Playbooks CLI commands.

That gives agents access to common Playbooks workflows such as:

  • authentication and session checks
  • account and discovery lookups
  • local project actions like download, add, and clone
  • play lifecycle actions like submit, publish, sync, and deploy

By default, it uses the same Playbooks config file as the CLI: ~/.playbooksrc.

PrevCliNextQuickstart