Freero MCP server
Commit Nov 12, 2026Allows AI assistants to read, propose changes to, and collaboratively edit real-time infinite canvas whiteboards.
Also known as antonber/freero
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is Freero MCP?
Freero allows AI assistants to read, propose changes to, and collaboratively edit real-time infinite canvas whiteboards.
Summary generated from the project's README
About Freero MCP server
Freero provides an infinite canvas environment designed for real-time collaboration between human teams and AI agents. It allows MCP clients like Claude or ChatGPT to read existing boards and propose changes that users can subsequently accept. The platform supports a wide variety of content including sticky notes, 21 different shapes, connectors, task cards, and mind maps. Users can also incorporate images, PDFs, and even video or audio files directly onto the canvas.
Developers can use the hosted version at freero.app or deploy the software themselves using a Docker image. The system is built with a stack featuring React, TypeScript, and Yjs for synchronization. For local development, it requires Node 22+ and can run a server on port 4000. Self-hosting options include a full stack setup with Postgres, Redis, and MinIO. The server supports different user roles such as owner, editor, commenter, and viewer to manage permissions during brainstorming or workshop sessions.
What you can do with it
- 1Collaborative BrainstormingAsk an AI agent to generate a mind map or a set of sticky notes on a shared board.
- 2Visual PlanningHave an AI assistant organize complex diagrams using various shapes and connectors.
- 3Workshop FacilitationUse the built-in tools to manage group activities like voting or timed sessions.
- 4Template Based DesignInstruct an AI to set up a specific framework using one of the many pre-made layouts.
Written from the project's README. Every use case is checked against a quote from it.
How to install Freero MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Freero MCP in Claude Code
$ claude mcp add --transport http freero https://freero.app/mcpInstall Freero MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"freero": {
"url": "https://freero.app/mcp"
}
}
}Install Freero MCP in VS Code
.vscode/mcp.json
{
"servers": {
"freero": {
"type": "http",
"url": "https://freero.app/mcp"
}
}
}Install Freero MCP in VS Code CLI
$ code --add-mcp '{"name":"freero","type":"http","url":"https://freero.app/mcp"}'Install Freero MCP in Codex
$ codex mcp add freero --url https://freero.app/mcpInstall Freero MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.freero] url = "https://freero.app/mcp"
Install Freero MCP in Gemini CLI
$ gemini mcp add -s user --transport http freero https://freero.app/mcpInstall Freero MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"freero": {
"url": "https://freero.app/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableantonber/freero is public and reachablegithub.com/antonber/freero ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/antonber/freero ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubFreero
A free, open-source (MIT) real-time collaborative whiteboard: an infinite canvas for teams and their AI agents to brainstorm, plan, diagram and run workshops together. Claude, ChatGPT and other MCP clients read boards and propose changes that people accept.
Use it free at freero.app, or self-host it from one Docker image (deployment). Key facts: freero.app/facts.
What's in it
- Canvas — infinite pan/zoom, dot grid, minimap, snapping and alignment guides, multi-select, resize/rotate, groups, lock, undo/redo, copy/paste across boards, drag-and-drop import.
- Content — sticky notes, 21 shapes, rich text, connectors (straight/elbow/curved, attached, labelled), pen + highlighter + eraser, images, emoji and stamps, frames, task cards, mind maps, tags, PDFs, video and audio that play on the board, and file cards for any other file.
- Collaboration — live sync, cursors and selections, avatars, follow a collaborator, "bring everyone to me", emoji reactions, comment threads, owner/editor/commenter/viewer roles, share by invite or link.
- Facilitation — voting sessions, a shared timer, presentation mode over frames.
- Templates & export — 586 original templates (retrospectives, planning, workshops, diagrams, strategy and more); export PNG/JPG/SVG, frames to PDF, copy as image.
- Dashboard — boards grid/list, search, filters, stars, live thumbnails, duplicate, sharing.
Run it
Requires Node 22+.
npm install
npm run dev # server on :4000 + web on :5173
Open http://localhost:5173 and log in with the seeded demo account
demo@freero.app / freero123 (development only), or sign up.
http://localhost:5173/board/local is an offline sandbox board that needs no server.
Production:
npm run build && npm start # serves the built web app and the marketing site (apps/site) on :4000
docker compose up --build -d # or the full stack: proxy, 2 app replicas, Postgres, Redis, MinIO, Mailpit on :8080
Deploying for real: docs/deployment.md · every setting: docs/configuration.md · backups, monitoring, incidents: docs/operations.md.
Configuration: PORT (default 4000), FREERO_DATA_DIR (default ./data — the built-in PGlite
database in data/pg + uploads), DATABASE_URL (use a real Postgres instead), DATABASE_POOL_MAX
(default 10). Had boards from before the move to Postgres? Stop the dev server and run
npm run db:import-sqlite once.
Develop
| Command | What it does |
|---|---|
npm run check |
Architecture boundaries + typecheck + unit tests |
npm run verify |
Real-session end-to-end check: real server, real Yjs WebSocket clients, roles, persistence |
npm run new:feature <name> -- … |
Scaffold a feature folder (see ARCHITECTURE.md) |
node scripts/ui-shot.mjs --url … --out … |
Drive the real UI in headless Chromium and screenshot it |
Freero follows the Dune method:
features are isolated folders discovered by reserved file names, every piece of state has one
writer, and forbidden dependencies fail npm run check with an error that names the supported
path. Read ARCHITECTURE.md before changing code.
Stack: React 18 + TypeScript + Vite, Yjs (CRDT) over WebSockets, Express + ws, PostgreSQL
(pg; PGlite for dev/tests), Playwright for UI verification.
License
MIT. Dependencies are kept to permissive licences (MIT, Apache-2.0, MPL-2.0); GPL, AGPL and source-available projects are integrated at the protocol level only, never vendored.
Freero MCP questions
How do I add Freero MCP to Claude Code?
Run claude mcp add --transport http freero https://freero.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Freero MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can AI agents use Freero?
Yes, AI clients like Claude and ChatGPT can read boards and propose changes that users can then review and accept.
What kind of content can be added to the canvas?
The canvas supports sticky notes, various shapes, rich text, connectors, images, PDFs, video, audio, and task cards.