Skip to content
MCP server

PlainHub

Open files and diffs in a GitHub editor and keep an agent decision ledger in your repo

Runs locallyStatus and history
Pricing
Freemium
Platforms
Web, CLI, iOS
Runs
Locally
Version
1.8.5
Listing updated
3 days ago

About PlainHub

PlainHub is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

PlainHub is a browser and phone editor for Markdown and plain-text files in your own GitHub repositories, where every save is a commit and file contents never pass through PlainHub's servers. The MCP server, from the open-source plainhub npm package, lets an agent open files and diffs there.

Its distinctive part is a ledger: agents write messages and decision cards as Markdown files in .agents/ of your repository using plainhub_ledger_init, plainhub_post, plainhub_decide, plainhub_ledger_read and plainhub_ledger_sync, then push with Git. In PlainHub, cards waiting for a decision show Approve and Decline buttons on desktop or phone. Through MCP an agent cannot choose the owner role, so approving is left to a person.

The ledger works without the PlainHub app, and a separate feature connects the Claude Code on your own PC to an AI panel using your Claude account. The CLI and MCP server are MIT licensed; the hosted app is not open source.

Install

Run in a terminal

claude mcp add plainhub -- npx -y plainhub

Add to claude_desktop_config.json

{
  "mcpServers": {
    "plainhub": {
      "command": "npx",
      "args": [
        "-y",
        "plainhub"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "plainhub": {
      "command": "npx",
      "args": [
        "-y",
        "plainhub"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "plainhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "plainhub"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "plainhub": {
      "command": "npx",
      "args": [
        "-y",
        "plainhub"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "plainhub": {
      "command": "npx",
      "args": [
        "-y",
        "plainhub"
      ]
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

plainhub_ledger_init
No description
plainhub_post
No description
plainhub_decide
No description
plainhub_ledger_read
No description
plainhub_ledger_sync
No description

What it does

Agent decision cards
Agents post cards you approve or decline from a phone.
Ledger in your repo
Messages live as Markdown under .agents/ and sync with Git.
Open files and diffs
An agent can open a file or diff in the editor.
Human-only approval
Agents cannot take the owner role.
Works without the app
The ledger depends only on Git and Node.js 18 or later.

Good for

  • Ask a person to approve an agent's plan from a phone
  • Keep a shared agent log in a GitHub repository
  • Open a diff an agent made in the browser editor
  • Edit notes in GitHub from any device

Pricing

Freemium

CLI and MCP server MIT; hosted app prices not published

Prices change. Check plainhub.dev before you buy.

PlainHub FAQ

Can an agent approve its own cards?

No. Through MCP an agent can't choose the owner role.

Does PlainHub store my files?

No. They stay in your GitHub and don't pass through PlainHub's servers.

What do I need for the ledger?

Git and Node.js 18 or later.

Is PlainHub free?

PlainHub has a free plan, with paid plans for more usage or features.

How do I add PlainHub to Claude Code?

Run this command in your terminal: claude mcp add plainhub -- npx -y plainhub

What are the best alternatives to PlainHub?

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

Alternatives to PlainHub

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity