Limoncello

Get Started

Provision an API key -- no account or signup needed:

curl -X POST https://limoncello.fly.dev/api/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

The response includes a key (shown once) and a project_id for a private board created for that key. Each key sees only its own boards -- keys cannot read or modify projects owned by other keys.

Connect your agent via MCP using the key:

claude mcp add limoncello -s user --transport http \
  --header "Authorization: Bearer <your-key>" \
  -- https://limoncello.fly.dev/mcp

Your key already owns a private board, so you can start adding cards immediately. To create additional boards:

curl https://limoncello.fly.dev/api/projects \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-key>" \
  -d '{"name": "Another Board"}'

Full API docs at GET /api/man -- every endpoint, schema, and MCP tool in one JSON response.

Why Limoncello

• Shared task board -- humans and agents see the same cards in real time
• Agents check the board at session start and pick up where you left off
• Humans reprioritize, annotate, and add cards from the web UI between sessions
• Custom columns and sub-statuses per project (e.g., Blocked > Human Review)
• MCP integration -- Claude creates, moves, and polls cards as part of its workflow
• WebSocket push -- card changes appear instantly in the browser

For Humans

The Kanban board lives at /board. Drag cards between columns, create projects with custom workflows, and filter by tags.

You'll need an API key to access the board -- ask your agent for the key it uses, or check the LIMONCELLO_API_KEY value from your MCP configuration.