# PlainHub

> PlainHub is a freemium MCP server for developer tools. Open files and diffs in a GitHub editor and keep an agent decision ledger in your repo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, CLI, iOS, Android
- **Website:** https://plainhub.dev
- **Repository:** https://github.com/ricrio-inc/plainhub
- **MCP Registry name:** io.github.ricrio-inc/plainhub
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add plainhub -- npx -y plainhub
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `plainhub_ledger_init`
- `plainhub_post`
- `plainhub_decide`
- `plainhub_ledger_read`
- `plainhub_ledger_sync`

## 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

- [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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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