Skedra Whiteboard README

Whiteboard · MCP for AI agents · Libraries · Self-host · React SDK

Skedra Whiteboard — the open-source visual workspace for people and AI agents.

Local-first. Agent-editable. Collaborative. Self-hostable.

Skedra Whiteboard is a modern infinite canvas for sketching ideas, mapping systems, planning projects, and collaborating with people or AI agents. Through its 23-tool MCP server, agents can create and edit native Kanban boards, Gantt timelines and diagrams instead of returning flat screenshots. Use the free whiteboard at skedra.xyz, or run the complete Community edition on your own infrastructure.

Features

Infinite canvas with shapes, text, arrows, freehand drawing, images, and frames
Visual workflows for flowcharts, mind maps, graphical sequence diagrams with optional Mermaid import, Gantt charts, kanban boards, and reusable templates
Local-first whiteboard that works without creating an account
Real-time collaboration with encrypted canvas updates and assets
Team workspaces with roles, permissions, comments, mentions, and activity
Shareable boards for guests, presentations, and read-only embeds
MCP server with 23 structured tools for agent-editable boards, plans, diagrams, members, and activity
Shape libraries with .skedralib import, private collections, and a community catalog
Portable files with the open .skedra format
Optional AI and voice calls using your own providers
Dark mode and localization for a comfortable workspace

MCP for AI agents

Connect Codex, Claude, Cursor, OpenCode or another Streamable HTTP client to the hosted server:

text

https://skedra.xyz/api/mcp

Create an account, then open Settings > API Keys & MCP for a generated, client-specific configuration. New Founding Users receive 30 days of Skedra Cloud access without a credit card.

The result of an agent call is a normal editable Skedra board. Humans can keep moving cards, changing dependencies and refining diagrams while the agent reads and updates the same structured elements.

Skedra Community

Skedra Community is the complete open-source workspace: the web app, accounts, teams, persisted boards, collaboration, comments, libraries, API, database, and self-hosting tools.

The canvas is also available as reusable, auth-free packages:

@skedra/canvas-core — canvas model and algorithms
@skedra/canvas-editor — shared editor interactions
@skedra/canvas-react — shared SVG renderer
@skedra/react — embeddable React editor

See Community scope for the exact project boundary.

Self-host Skedra

The fastest way to run Skedra is the all-in-one Docker image:

Terminal

docker run -d \
  --name skedra \
  -p 3000:80 \
  -v skedra_data:/data \
  ghcr.io/moonriddim/skedra-community-standalone:latest

Open http://localhost:3000. Your boards, database, and instance secrets are kept in the skedra_data volume.

For Docker Compose, production domains, external storage, LiveKit, updates, and backups, follow the self-hosting guide.

Development

bash

git clone https://github.com/moonriddim/skedra-community.git
cd skedra-community
docker compose -f docker-compose.dev.yml up -d
cp .env.example .env
pnpm install
pnpm db:push
pnpm dev

Open http://localhost:5174.

pnpm dev also keeps the public React SDK artifacts current while shared canvas code changes. Use pnpm dev:sdk for the SDK watcher alone and pnpm sdk:verify to run the focused Web/SDK parity, package, and build checks.

Contributing

Skedra is built in the open, and contributions are welcome.

Found a bug or have an idea? Open an issue.
Want to improve the code? Fork the repository and open a pull request.
Planning a larger change? Start with an issue so we can align on the direction.

License

Skedra Community is licensed under AGPL-3.0-only. The reusable canvas-core, canvas-editor, and react packages are available under the MIT License.