writbase — Claude Code MCP server: tasks and setup
writbase gives AI agents a persistent Supabase task registry with scoped access, delegation, and an audit trail through MCP.
claude mcp add --env WRITBASE_URL=<WRITBASE_URL> --env WRITBASE_AGENT_KEY=<WRITBASE_AGENT_KEY> --transport stdio writbase -- npx -y writbaseWhat writbase does
writbase connects an agent to a persistent task registry over MCP. Worker agents can inspect, create, and update tasks with filters, search, and pagination. Manager agents can administer keys, permissions, projects, departments, webhooks, and provenance records.
The service runs through a Supabase Edge Function backed by Postgres. Access is scoped to a project and department, while version checks catch conflicting updates. Setup needs Node 18+, the Supabase CLI, a Supabase project, and an agent key. The key is shown once, so save it before configuring the client.
What it helps with
- keep one task registry for several agents
- limit access by project and department
- delegate work between agents
- trace who changed a task and why
- catch conflicting task updates
Example prompts for the agent
- Create a task in
my-appto fix the login bug and assign it to the backend agent. - List high-priority tasks in
my-app. - Move the latest task to
in_progressand use its current version.
How to install writbase
1Platform CLI
claude mcp add --env WRITBASE_URL=<WRITBASE_URL> --env WRITBASE_AGENT_KEY=<WRITBASE_AGENT_KEY> --transport stdio writbase -- npx -y writbaseReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http writbase https://{PROJECT_REF}.supabase.co/functions/v1/mcp-server/mcp1Platform CLI
codex mcp add writbase --env WRITBASE_URL=<WRITBASE_URL> --env WRITBASE_AGENT_KEY=<WRITBASE_AGENT_KEY> -- npx -y writbaseReplace <…> with your own values
2Platform CLI: remote server
codex mcp add writbase --url https://{PROJECT_REF}.supabase.co/functions/v1/mcp-server/mcp1Config file
{
"mcpServers": {
"writbase": {
"command": "npx",
"args": [
"-y",
"writbase"
],
"env": {
"WRITBASE_URL": "<WRITBASE_URL>",
"WRITBASE_AGENT_KEY": "<WRITBASE_AGENT_KEY>"
}
}
}
}Replace <…> with your own values
2Config file
{
"mcpServers": {
"writbase": {
"url": "https://{PROJECT_REF}.supabase.co/functions/v1/mcp-server/mcp"
}
}
}1Config file
{
"servers": {
"writbase": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"writbase"
],
"env": {
"WRITBASE_URL": "<WRITBASE_URL>",
"WRITBASE_AGENT_KEY": "<WRITBASE_AGENT_KEY>"
}
}
}
}Replace <…> with your own values
2Config file
{
"servers": {
"writbase": {
"type": "http",
"url": "https://{PROJECT_REF}.supabase.co/functions/v1/mcp-server/mcp"
}
}
}1Platform CLI
gemini mcp add -e WRITBASE_URL=<WRITBASE_URL> -e WRITBASE_AGENT_KEY=<WRITBASE_AGENT_KEY> writbase npx -y writbaseReplace <…> with your own values
2Platform CLI: remote server
gemini mcp add -t http writbase https://{PROJECT_REF}.supabase.co/functions/v1/mcp-server/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about writbase
How do I install writbase in Claude Code?
Create a Supabase project and an agent key, then run claude mcp add --env WRITBASE_URL=<WRITBASE_URL> --env WRITBASE_AGENT_KEY=<WRITBASE_AGENT_KEY> --transport stdio writbase -- npx -y writbase.
What does writbase do?
It gives MCP clients a shared task registry. Agents can read, create, and update tasks, while manager agents handle projects, keys, permissions, and audit data.
How are writbase permissions scoped?
Permissions apply to a project and department pair. Available actions include reading, creating, updating, assigning, commenting, and archiving tasks.
