Documentation

Freero documentation

The guides live next to the code, so they change with it. Start with the MCP server if you want an assistant on your boards, or with deployment if you run your own Freero.

Quick starts: connect Claude · connect ChatGPT · build an agent · self-host

Agents and integrations

Connect assistants and build your own.

  • MCP server

    Connect Claude, ChatGPT, Claude Code, Cursor and VS Code; permissions, safety and every tool.
  • Board outline

    The structured read of a board that agents and the REST API return.
  • REST API

    Tokens, OAuth apps, scopes and the rules every call follows.
  • Events and webhooks

    The event contract, signatures, retries and the Slack and Teams formats.
  • Issue trackers

    Jira, Linear and GitHub: connecting, what maps to what, conflicts, roadmaps.
  • AI in Freero

    The built-in AI actions, your model provider, and what happens to your data.

Running Freero

For operators of a self-hosted Freero.

  • Deployment

    One VM with Docker Compose, or any cloud with managed services; TLS, scaling, upgrades.
  • Configuration

    Every environment variable, its default and what it does.
  • Operations

    Backups and restores, monitoring, secret rotation, SSO, GDPR requests, moderation.
  • Accessibility

    Keyboard and screen-reader support, how it is checked, and the known gaps.

Contributing

How the code is organised.

  • Architecture

    Layers, single writers, the server modules and how features are discovered.
  • README

    Run Freero locally and the commands that check a change.

API reference

Every Freero server serves its OpenAPI 3.1 description at /api/v1/openapi.json; load it into your API client or code generator.

Bring your team and your agents to one board

Free to use, open source, and yours to host. No credit card, no seat count.