mapache

<p align="center"> <img src="docs/banner.png" alt="Mapache: mind maps and whiteboard your AI agent can draw on. Open source, MCP built in, works offline, teams and live cursors" width="100%"> </p> <h3 align="center">Mind maps and an infinite whiteboard on your computer, and your AI agent can draw on it too.<br>Open source. Works offline. No account.</h3> <p align="center"> <a href="#-quick-start"><b>Quick start</b></a> · <a href="#-your-ai-agent-can-use-it-too">AI agents (MCP)</a> · <a href="#-for-teams-beta">Teams</a> · <a href="#-features">Features</a> · <a href="#%EF%B8%8F-keyboard-first">Shortcuts</a> · <a href="#%EF%B8%8F-roadmap">Roadmap</a> · <a href="README.es.md">Español</a> </p> <p align="center"> <a href="https://github.com/Hackeatutiempo/mapache/actions/workflows/test.yml"><img alt="Tests" src="https://github.com/Hackeatutiempo/mapache/actions/workflows/test.yml/badge.svg"></a> <a href="LICENSE"><img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-8b5cf6"></a> <a href="#-your-ai-agent-can-use-it-too"><img alt="MCP server included" src="https://img.shields.io/badge/MCP-built%20in-a78bfa"></a> <img alt="Zero dependencies" src="https://img.shields.io/badge/dependencies-0-22c55e"> <img alt="Works offline" src="https://img.shields.io/badge/works-offline-0ea5e9"> <img alt="No build step" src="https://img.shields.io/badge/build%20step-none-f59e0b"> <a href="#-contributing"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-f97316"></a> <a href="https://github.com/Hackeatutiempo/mapache/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/Hackeatutiempo/mapache?style=social"></a> </p> <p align="center"> <img src="docs/demo.gif" width="860" alt="Building a mind map, a sticky note and a shape in seconds, only with the keyboard"> </p>

---

Why Mapache?

Most whiteboard tools want an account, a monthly fee and a copy of your ideas on their servers. Mapache is a folder you run on your own computer. Your boards are plain files on your disk, it opens instantly, it keeps working on a plane, and your AI agent can read them and build on them with you.

• ⚡ Fast like a native app. No framework, no build step, no loading spinners.
• 🧠 Mind maps that keep up with you. Tab for a child, Enter for a sibling, drag to re-parent, colored branches, and as many maps as you want on one board.
• 🎨 A real whiteboard around them. Sticky notes, 12 shapes, sections, connectors that route around objects, freehand drawing with shape recognition, images and videos.
• 📊 Data built in. Paste a table from Excel or Google Sheets and turn it into any of 17 chart types.
• 💬 Comments and mentions. Pin a comment anywhere, reply, resolve, and @mention people (or let your agent leave notes for you to review).
• 🤖 Made for AI agents. A built-in MCP server lets Claude, Codex, Cursor and friends read your boards and create mind maps, notes, flowcharts and tables. You watch them appear live.
• 🔒 Yours, for real. Local-first, no telemetry, plain JSON files you can read, back up or put in Git. AGPL-3.0.

| | Mapache | Typical SaaS whiteboard | |---|:---:|:---:| | Price | Free | Free tier, then per seat | | Account required | No | Yes | | Where your boards live | Files on your computer | Their cloud | | Works offline | Yes | Limited | | Your AI agent can read and edit boards | Yes, locally (MCP) | Through their cloud, if at all | | Team server with accounts and live cursors | Yes, self-hosted with Docker | Their cloud, per seat | | Open source and self-hostable | Yes | No | | Dependencies to install | 0 | — |

🤖 Let your AI agent install it

Not technical? Give this to your AI agent (Claude Code, Codex, Cursor…) and it does everything for you:

Install Mapache for me following https://github.com/Hackeatutiempo/mapache/blob/main/AGENTS.md,
connect it to yourself as an MCP server, and leave a shortcut so I can open it with a double-click.

The step-by-step guide for agents lives in AGENTS.md: it checks Node.js, gets the code, starts it, creates a desktop shortcut, connects the MCP server and explains where your boards are saved.

🚀 Quick start

All you need is Node.js 18 or newer. There is nothing else to install.

git clone https://github.com/Hackeatutiempo/mapache.git
cd mapache
npm start

Open http://localhost:4321 and start thinking. Next time, double-click Abrir Mapache.cmd (Windows) or run ./start.sh (macOS and Linux): they start Mapache in the background if needed and open the browser.

Tip: in Chrome or Edge choose Install app in the address bar. Mapache gets its own window and icon and works even when the server is off; your changes sync to your files as soon as it is back.

Your boards are saved automatically as JSON files in ~/.mapache (run node bin/mapache.js where to see the exact folder). Export backup (bottom left) still gives you everything in one file.

🤖 Your AI agent can use it too

Mapache ships with an MCP server (the open standard that lets AI agents use tools) and a command line. Connect it once and ask things like:

"Turn my notes from today's meeting into a mind map in Mapache."<br> "Read the board I have open and add a risks branch with three ideas under each one."<br> "Draw the onboarding flow as a flowchart with a decision for paid and free users."<br> "Put these sales numbers in a table on my Q4 board and add a column chart."

<p align="center"><img src="docs/agent-demo.gif" width="860" alt="An AI agent builds a product launch board in Mapache: a mind map, sticky notes and a signup flowchart appear live"></p>

If Mapache is open in your browser, the changes appear live, and Ctrl+Z undoes them. Everything runs on your computer: the MCP server reads and writes the same files the app uses.

The easiest way: in the app, click Connect your AI agent (bottom left) and copy the prompt into your agent. Or connect it yourself (replace the path with where you installed Mapache; node bin/mapache.js mcp-config prints these with your real paths):

| Agent | How to connect | |---|---| | Claude Code | claude mcp add --scope user mapache -- node ~/Mapache/bin/mapache.js mcp | | Claude Desktop | Settings > Developer > Edit config, then add the JSON below | | Codex (OpenAI, included with ChatGPT plans) | codex mcp add mapache -- node ~/Mapache/bin/mapache.js mcp | | Gemini CLI | gemini mcp add mapache node ~/Mapache/bin/mapache.js mcp | | Cursor, Windsurf | add the JSON below to ~/.cursor/mcp.json or ~/.codeium/windsurf/mcp_config.json | | VS Code | MCP: Open User Configuration, add "mapache": { "type": "stdio", "command": "node", "args": ["~/Mapache/bin/mapache.js", "mcp"] } under servers | | ChatGPT (web or phone) | It cannot reach your computer on its own. Use Codex, or a bridge such as Desktop Commander, and ask ChatGPT to use the mapache command line |

{ "mcpServers": { "mapache": { "command": "node", "args": ["/full/path/to/Mapache/bin/mapache.js", "mcp"] } } }

<details> <summary><b>Tools the agent gets</b></summary>

| Tool | What it does | |---|---| | list_boards, read_board, search_boards | See every board and read one as an outline, with ids | | create_board, update_board, delete_board, create_folder | Organize boards (deleting moves them to the trash) | | add_nodes, update_nodes, move_node, delete_nodes, add_mindmap | Grow and edit mind maps from indented outlines | | add_items, update_items, delete_items | Sticky notes, text, shapes, sections, stickers, tables, charts and video embeds | | connect | Arrows between anything, with labels | | list_comments, add_comment, reply_comment, resolve_comment | Read and write comments, with @mentions | | export_board | Save a board as a shareable web page, PDF, PNG or SVG | | open_board | Show a board in the browser |

Agents write simple Markdown (# heading, - bullet, [ ] task, **bold**, links) and new content is placed in free space automatically. "open" always means the board you are looking at.

</details> <details> <summary><b>Command line</b></summary>

node bin/mapache.js help                      # everything it can do
node bin/mapache.js list                      # boards and folders
node bin/mapache.js show open                 # the board open in the app, as an outline
node bin/mapache.js new "Launch plan" --outline @plan.txt
node bin/mapache.js add open "Marketing" "Webinar" "Podcast"
node bin/mapache.js tool add_items '{"board":"open","items":[{"type":"note","text":"Call Ana"}]}'
node bin/mapache.js export open --format pdf  # save the open board as a PDF in Downloads
node bin/mapache.js start | stop | status | open
node bin/mapache.js autostart on              # start Mapache when you log in

Run npm link inside the folder once to get a global mapache command.

</details>

👥 For teams (beta)

Run one Mapache for your whole team on your own server: accounts with email and password, invitation links, roles (admin, can edit, can view), live cursors and avatars of who is on each board, and every change on everyone's screen as it happens. Each person can connect their own AI agent with a personal token.

<p align="center"><img src="docs/team.png" width="860" alt="A team board in Mapache: another person's live cursor with her name, her avatar at the top, a comment pin and the mentions bell"></p>

git clone https://github.com/Hackeatutiempo/mapache.git && cd mapache
docker compose up -d          # then open http://<server>:4321 and use the setup code from: docker logs mapache

With a domain, docker compose --profile https up -d adds automatic HTTPS. Everything is in TEAM.md. Team mode is new: try it with your team and tell us what breaks.

✨ Features

Mind maps that grow as fast as you think

Quick-add dots, Tab and Enter, drag a branch and watch the map re-flow live, collapse with a counter, horizontal or vertical layouts, curved or angular lines. Paste an indented outline and it becomes a map.

<p align="center"><img src="docs/feature-mindmap.png" width="860" alt="A colorful mind map with five branches"></p>

Flowcharts with connectors that route themselves

Connect shapes, notes, tables or mind map nodes. Ends keep their side while the path re-routes around objects; drag any segment to shape it by hand. Elbow, curved or straight, with labels and nine end caps.

<p align="center"><img src="docs/feature-flow.png" width="760" alt="A flowchart inside a section with Yes and No branches"></p>

Your data, as charts

Paste from Excel, Google Sheets, Notion or Markdown, or drop a CSV. Charts stay linked to their table and update while you type. Color-blind-safe palettes in light and dark mode.

<p align="center"><img src="docs/feature-data.png" width="760" alt="A table and the column chart built from it"></p>

Share it with anyone

Export a board as a single web page: send it by email or chat and it opens in any browser, with zoom and pan, nothing to install. Or as PDF, PNG or SVG. Your agent can do it too ("save this board as a PDF on my desktop").

Light or dark, your call

<p align="center"><img src="docs/screenshot-light.png" width="860" alt="Mapache in light mode with folders, a mind map, notes, a flowchart and a chart"></p> <details> <summary><b>Everything that is inside</b></summary>

| | | |---|---| | Mind maps | As many as you want on one board (M). Horizontal or vertical layout, curved or angular lines, branch colors, icons, bullet, numbered and checklist nodes, paste an indented outline to create branches | | Notes and text | Sticky n