# Flanner

> Flanner is a freemium MCP server for developer tools. Version-controls the plan files Claude Code and Codex write, and flags stale ones. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** CLI, self-hosted
- **Website:** https://flanner.io
- **Repository:** https://github.com/elandlabs/flanner
- **MCP Registry name:** io.github.jaysonmulwa/flanner
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-16

## About

Flanner treats the markdown plans that coding agents produce as documents with a history. Each edit becomes a new numbered version, you can diff any two, and a status backed by evidence (dead references, commits since it was written, age) tells you when a plan has gone stale. Plans live in a .plans/ directory that is kept out of git until you decide otherwise.

It works through three surfaces on one local SQLite catalogue: a CLI, the MCP server your agent drives, and a local web UI. Running flanner init registers it with Claude Code and Codex and adds a guard hook plus managed CLAUDE.md and AGENTS.md blocks so agents save plans through it. Add-ons cover searchable project memory that refuses secrets, a scan of which skills an agent actually loads, and Curb, which maps which credentials and channels an agent can reach. Curb deliberately has no MCP tools.

The local tool needs no account. A paid Mesh tier syncs plans, memory and skills between your own devices or a team device to device, with the hosted side handling accounts and access rather than content.

## Features

- **Versioned plans:** Every revision is kept with full history and can be diffed.
- **Staleness status:** Reports dead references and commits since a plan was written.
- **Git protection:** Keeps plan files out of commits automatically.
- **Agent integration:** Init adds a guard hook and CLAUDE.md and AGENTS.md guidance.
- **Project memory:** Saves decisions and constraints as searchable markdown and refuses secrets.
- **Curb reports:** Shows which credentials and channels an agent can reach, as counts rather than names.
- **Mesh sync:** Optional paid device-to-device sync for individuals and teams.

## Good for

- Keeping design docs written by agents from piling up and rotting
- Seeing what a plan said before the agent changed its mind
- Sharing plans and memory across a team without a central store
- Auditing what a coding agent can read on your machine

## Install

### Claude Code (Terminal)

```sh
claude mcp add flanner -- uvx flanner
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "flanner": {
      "command": "uvx",
      "args": [
        "flanner"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "flanner": {
      "command": "uvx",
      "args": [
        "flanner"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "flanner": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "flanner"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "flanner": {
      "command": "uvx",
      "args": [
        "flanner"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "flanner": {
      "command": "uvx",
      "args": [
        "flanner"
      ]
    }
  }
}
```

## FAQ

### Is it free?

The CLI, MCP server and local web UI are free and open source under MIT; Mesh sync is a paid add-on.

### Do I need an account?

No, not for the local tool. An account matters only for Mesh.

### How do I install it?

uv tool install flanner, then flanner init in your project.

### What does Personal Mesh cost?

$9 a month for one person on up to 5 devices, with a 30-day trial.

### Which assistants does it support?

Claude Code and Codex out of the box, plus any MCP client.

### Is Flanner free?

Flanner has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Flanner to Claude Code?

Run this command in your terminal: claude mcp add flanner -- uvx flanner

### What are the best alternatives to Flanner?

The closest alternatives to Flanner are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/flanner
