Plainhub MCP Server

PlainHub

A GitHub editor, wired to Claude Code

Open, write and save Markdown and plain-text files in your own GitHub repos from a browser or phone; every save is a commit. Connect the Claude Code on your PC, talk to it by voice, and approve its proposals from anywhere. Your files stay in your GitHub.

Website · ▶ 30-second intro (YouTube) · Documentation · 日本語ドキュメント · Why I built it

Three ways to use it

1. Edit — open, write, save

Open a file in your GitHub repositories, write, and save — no Git knowledge required. Every save is a commit in your own repository. Ask the AI about the file in front of you, and review each proposed edit before it is applied. → User Guide

2. Ledger — progress and decision cards in your repo

Your agents write their messages and decision cards as Markdown files in .agents/ in your own repository. Send it to GitHub with plainhub ledger sync . and open the repository in PlainHub. If you can write to it, decision cards waiting for you show Approve and Decline buttons, on your PC or your phone. Starting a ledger needs only Git and Node.js 18 or later. → How to use the ledger

3. Your agent — connect your own Claude Code

Ask in the PlainHub AI panel, and Claude Code on your own PC answers — from the same PC or from your phone. No API key needed: it runs signed in with your own Claude account. → Your agent

What's inside

The cli/ folder is the source of the npm package plainhub: the CLI, the MCP server, Your agent and the ledger. It holds the same files as the published version on npm.

The ledger works without PlainHub. Your AI agents write messages and decision cards as Markdown files in .agents/ of your own repository, with the MCP tools plainhub_ledger_init, plainhub_post, plainhub_decide, plainhub_ledger_read and plainhub_ledger_sync (or the same plainhub commands), and send them with Git. Nothing goes through PlainHub's servers or screens, and there is no other service to depend on. → Use without PlainHub

A person decides. Through the MCP tools, an agent can't choose the owner role, so approving a card is left to a person. PlainHub is the easiest place to do that: open the repository on your phone and press Approve.

Some comments are in Japanese.

Why PlainHub

• GitHub-native — Your files are saved only in your own GitHub repository. PlainHub doesn't store them.
• File contents never pass through PlainHub's servers — Reading and saving go directly between your browser and the GitHub API. Sign-in uses a small server step — see the privacy policy.
• BYOK (Bring Your Own Key) — Use your own AI API keys (e.g., Anthropic Claude). Keys stay in your browser, never sent to PlainHub servers.
• AI for idea development — Brainstorm, write, and edit alongside an AI assistant. Voice input and TTS read-aloud supported.
• Frontend for GitHub — Like github.dev, but for non-engineers. A notepad with version control built in.

Features

Edit from your phone

Open a note on your phone, fix a line, and it is saved — as a commit in your own repository.

Editor

• Markdown 3-mode editing — Code / Visual (WYSIWYG) / Preview
• Syntax highlighting — Markdown, JSON, YAML, and more
• Undo / Redo — Full edit history
• Line numbers, auto-indent, line wrapping — Configurable
• Whitespace visualization — Toggle invisible characters
• Keyboard shortcuts — VS Code-style shortcuts (Ctrl+S, Ctrl+Z, etc.)

File Management

• Create / rename / duplicate / delete files and folders
• File history — View past versions with diff
• Sync & conflict resolution — Real-time sync with GitHub
• Image paste — Paste images directly, auto-upload to repo
• Cross-repo search — Search across all your repositories

Integration

• CLI — plainhub open <file> -r <repo> from your terminal
• MCP Server — Control from AI IDE (Claude Code, Cursor, VS Code)
• Deep linking — Share URLs with theme, font size, line number settings
• PWA — Install as native app on desktop and mobile

Design

• Dark / Light theme — Automatic or manual
• Mobile responsive — Full-featured on phone and tablet

Quick Start

Web

Visit plainhub.dev and sign in with GitHub.

CLI

npm install -g plainhub
plainhub auth --from-gh
plainhub open README.md -r owner/repo

MCP Server (AI IDE)

npm install -g plainhub
claude mcp add plainhub -- plainhub-mcp

Then say: "Open the README in owner/repo on PlainHub"

Documentation

• User Guide — Editor features and shortcuts
• Features — Key features, data ownership, enterprise
• Use Cases — When and how to use PlainHub
• CLI Reference — Terminal commands and options
• MCP Server — AI IDE integration
• Your agent — Connect your own Claude Code to the AI panel
• FAQ — Troubleshooting and common questions
• 日本語ドキュメント — Japanese documentation

Ask / Report

Ask a question or report a problem: open an issue — no question is too small. We usually reply within 2 business days.

• ❓ How do I…? — ask how to do something
• 🐞 Bug — something doesn't work as expected
• 💡 Idea — suggest an improvement

Replies may be drafted with the help of an AI assistant and are checked by the PlainHub team. Please don't post personal information, tokens, or private file contents — this repository is public.

Links

• App: app.plainhub.dev
• About: plainhub.dev

If PlainHub is useful to you, a star helps others find it.

License

The code in cli/ (the npm package plainhub) is released under the MIT License.

Documents and images: Copyright © 2025 ricrio Inc. All rights reserved.

The documents in this repository are generated from another place, so please don't edit them here. If something needs fixing, let us know with an issue.