# AgentPlaybooks

AgentPlaybooks keeps skills, project instructions, MCP servers, and memory in portable playbooks. Connect it to reuse agent setups across supported platforms.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: matebenyovszky
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/matebenyovszky/agentplaybooks
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/agentplaybooks

## What it does

AgentPlaybooks puts a persona, project rules, Agent Skills documents, MCP tools, and memory into a playbook. Its MCP server gives an agent access to playbooks, which can also be synced to a local agent configuration with the CLI. This suits workflows that move between platforms while keeping setup material in one place.

A playbook can include skill attachments such as scripts and templates, along with Canvas documents scoped to a run. Connected MCP servers and OpenAPI services can provide tools through the playbook. Credentials are stored in a secrets vault and resolved on the platform side, so their values stay out of the agent’s context.

For Claude Code, add the server with the HTTP command below. Running the project yourself requires Node.js 22+, npm 11+, and a Supabase project; Cloudflare is needed for deployment. npm 10 writes a lockfile that `npm ci` later rejects, so the npm version matters.

## Requirements
- Remote server: `https://agentplaybooks.ai/api/mcp/manage`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http agentplaybooks https://agentplaybooks.ai/api/mcp/manage
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add agentplaybooks --url https://agentplaybooks.ai/api/mcp/manage
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentplaybooks": {
            "url": "https://agentplaybooks.ai/api/mcp/manage"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentplaybooks": {
            "type": "http",
            "url": "https://agentplaybooks.ai/api/mcp/manage"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http agentplaybooks https://agentplaybooks.ai/api/mcp/manage
```

## When to use it
- keep agent instructions and skills in one playbook
- move a playbook setup between supported platforms
- sync a playbook with a local agent configuration
- connect MCP and OpenAPI services as playbook tools
- give an agent access to secrets without exposing their values

## Example prompts
- Show me the skills and project instructions in my AgentPlaybooks playbook.
- Connect the specified MCP server to this playbook and use its tools.
- Sync this playbook with my Claude Code configuration.

## Similar
- [add-agent-playbooks](https://affpapa.org/en/nevibecode/skills/add-agent-playbooks.md) — skill · 110 installs
- [Disposable Email For Agents](https://affpapa.org/en/nevibecode/mcp/disposable-email-for-agents.md) — MCP server · 419 installs
- [run.pay — Agent Marketplace](https://affpapa.org/en/nevibecode/mcp/runpay-agent-marketplace.md) — MCP server · 414 installs
- [ClawGuard Shield](https://affpapa.org/en/nevibecode/mcp/clawguard-shield.md) — MCP server · 395 installs
- [steledger](https://affpapa.org/en/nevibecode/mcp/mechnotech-steledger.md) — MCP server · 311 installs
- [Wax Seal](https://affpapa.org/en/nevibecode/mcp/wax-seal.md) — MCP server · 303 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
