# OthmanAdi/planning-with-files | Model Context Protocol (MCP) Server

> Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.

- **Stars**: ⭐ 26,088
- **Language**: Shell
- **Native MCP Manifest**: Standard NPX Transport

## 🔌 Claude Desktop Configuration (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "planning-with-files": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-planning-with-files"
      ]
    }
  }
}
```

## ⚡ Cursor MCP Configuration (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "planning-with-files": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-planning-with-files"
      ]
    }
  }
}
```

## 🚀 Launch Commands

- **NPX**: `npx -y @modelcontextprotocol/server-planning-with-files`
- **Docker**: `docker run -i --rm mcp/planning-with-files`