Developers
Cloverr API
Read and create tasks, docs and chat messages, search your workspace and ask Bees, from your own code or from AI agents over MCP.
REST https://api.cloverr.co.uk/v1
MCP https://mcp.cloverr.co.uk
Create a personal token in Cloverr under Settings → API & MCP, then send it as Authorization: Bearer <token>.
Endpoints
| Request | What it does | Scope |
|---|---|---|
| GET /v1/me | Who the token acts as | any |
| GET /v1/tasks?status=&projectId=&mine=true | List tasks | read |
| POST /v1/tasks {title, description, projectId, dueAt} | Create a task | write |
| PATCH /v1/tasks/:id {title, status, dueAt} | Update a task | write |
| GET /v1/projects | List projects | read |
| GET /v1/docs · GET /v1/docs/:id | List or read docs | read |
| POST /v1/docs {title, content} | Create a doc | write |
| GET /v1/chats | Chats you can post in | read |
| POST /v1/chats/:id/messages {text} | Post a message (@handle wakes a Bee) | write |
| GET /v1/search?q= | Search tasks, docs and email | read |
| GET /v1/bees | List Bees | read |
| POST /v1/bees/:handle/ask {prompt} | Queue a question; returns a run id | bees |
| GET /v1/runs/:id | A run's status and answer | bees |
Responses are { data } or { error: { code, message } }. Each token can make 120 requests a minute.
MCP
The MCP server offers the same actions as tools: search, list_tasks, create_task, update_task, list_projects, list_docs, read_doc, create_doc, list_chats, post_chat_message, list_bees, ask_bee and get_run. Connect with Streamable HTTP and the same Bearer token.