flanner — Claude Code MCP server: what it does, how to install
flanner keeps AI agent plans in one managed folder, tracks revisions, and exposes their history. Use it for architecture notes and migration plans.
claude mcp add flanner -- uvx flannerWhat flanner does
flanner exposes MCP tools for working with agent plans. Each plan receives YAML metadata, while every revision becomes a separate version with a history. Plans live in .plans/, and flanner init updates .gitignore, creates project configuration, and adds integration blocks to CLAUDE.md and AGENTS.md.
A local browser view lets you read and edit plans and walk through their revisions. Start it with flanner web --open-browser; the interface opens at http://localhost:8080. The server also keeps durable plan context as Markdown files and can inspect installed skills and an agent’s access to secrets. flanner-mcp must be available on PATH because the agent launches it by name.
Linear and JIRA links are disabled in this build. Enabling them requires FLANNER_INTEGRATIONS=1, while Linear issue checks use LINEAR_API_KEY.
What it helps with
- keep agent plans under
.plans/ - track revisions of an architecture plan
- connect a plan to a Linear or JIRA issue
- browse plan history in a local web view
- inspect loaded skills and agent access to secrets
Example prompts for the agent
- Create an architecture plan for the authentication service and save it through flanner.
- Show me the revision history for the architecture plan.
- Check which skills are loaded and which copy is active.
How to install flanner
Platform CLI
claude mcp add flanner -- uvx flanneruvx runs the command named after the package; if the README names another one, use uvx --from flanner <command>
Platform CLI
codex mcp add flanner -- uvx flanneruvx runs the command named after the package; if the README names another one, use uvx --from flanner <command>
Config file
{
"mcpServers": {
"flanner": {
"command": "uvx",
"args": [
"flanner"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from flanner <command>
Config file
{
"servers": {
"flanner": {
"type": "stdio",
"command": "uvx",
"args": [
"flanner"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from flanner <command>
Platform CLI
gemini mcp add flanner uvx flanneruvx runs the command named after the package; if the README names another one, use uvx --from flanner <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about flanner
How do I install flanner in Claude Code?
Run claude mcp add flanner -- uvx flanner.
What does flanner do?
It gives an AI coding agent MCP tools for storing plans, revisions, and related context. Plans stay in .plans/, with their history available through the local web view.
How does flanner connect plans to Linear or JIRA?
Linear and JIRA links are disabled in this build. Turn them on with FLANNER_INTEGRATIONS=1; checking a Linear issue also requires LINEAR_API_KEY.
