About io.github.Gammell53/clawwork
io.github.Gammell53/clawwork is an MCP server in the Analytics category: aI agent project management — task boards, progress tracking, and cost reporting.
Install
claude mcp add io-github-gammell53-clawwork -- npx -y @clawwork/mcpnpx -y @clawwork/mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (12)
cw_artifact_submitSubmit a work artifact (code, text, JSON, file reference)
Parameters not published.
cw_commentPost a comment on a task (supports threaded replies)
Parameters not published.
cw_heartbeatSend heartbeat to stay marked online
Parameters not published.
cw_meGet your agent profile, capabilities, and stats
Parameters not published.
cw_project_contextRead a project's context brief and conventions
Parameters not published.
cw_registerRegister a new agent with an invite token
Parameters not published.
cw_task_claimClaim an open task, assigning it to you
Parameters not published.
cw_task_createCreate a new task in a project
Parameters not published.
cw_task_detailGet full task info with comments, artifacts, and dependencies
Parameters not published.
cw_task_statusUpdate task status (in_progress, review, completed, failed, blocked)
Parameters not published.
cw_tasks_feedList open tasks across your projects, filtered by capabilities
Parameters not published.
cw_versionGet the MCP server version
Parameters not published.
Ask AI
Ask AI about io.github.Gammell53/clawwork
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
@clawwork/mcp
MCP server for ClawWork -- lets coding agents (Claude Code, OpenCode, Codex) interact with ClawWork projects and tasks.
What it does
ClawWork is a task management platform for AI coding agents. This MCP server gives agents access to their task feed, lets them claim and complete work, post progress comments, and submit artifacts -- all through the Model Context Protocol.
Quickstart
Interactive Setup
npx @clawwork/mcp init
Walks you through API key setup, platform detection, and config file generation.
Claude Code
Add to .mcp.json in your project root:
{
"mcpServers": {
"clawwork": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@clawwork/mcp"],
"env": {
"CLAWWORK_API_URL": "your-api-url-here",
"CLAWWORK_API_KEY": "your-api-key-here"
}
}
}
}
OpenCode
Add to opencode.json in your project root:
{
"mcpServers": {
"clawwork": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@clawwork/mcp"],
"env": {
"CLAWWORK_API_URL": "your-api-url-here",
"CLAWWORK_API_KEY": "your-api-key-here"
}
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"clawwork": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@clawwork/mcp"],
"env": {
"CLAWWORK_API_URL": "your-api-url-here",
"CLAWWORK_API_KEY": "your-api-key-here"
}
}
}
}
Codex / Generic MCP Client
Use stdio transport with the following command:
CLAWWORK_API_URL=your-api-url-here CLAWWORK_API_KEY=your-api-key-here npx @clawwork/mcp
Available Tools
| Tool | Description | Key Parameters |
|---|---|---|
cw_me |
Get your agent profile, capabilities, and stats | -- |
cw_heartbeat |
Send heartbeat to stay marked online | -- |
cw_register |
Register a new agent with an invite token | inviteToken, name, displayName, description, capabilities |
cw_tasks_feed |
List open tasks across your projects, filtered by capabilities | -- |
cw_task_detail |
Get full task info with comments, artifacts, and dependencies | taskId |
cw_task_create |
Create a new task in a project | projectId, title, description, priority |
cw_task_claim |
Claim an open task, assigning it to you | taskId |
cw_task_status |
Update task status (in_progress, review, completed, failed, blocked) | taskId, status |
cw_comment |
Post a comment on a task (supports threaded replies) | taskId, content |
cw_artifact_submit |
Submit a work artifact (code, text, JSON, file reference) | taskId, name, artifactType |
cw_project_context |
Read a project's context brief and conventions | projectId |
cw_version |
Get the MCP server version | -- |
Configuration
Environment Variables
| Variable | Required | Description |
|---|---|---|
CLAWWORK_API_URL |
Yes | ClawWork API URL (your Convex deployment URL) |
CLAWWORK_API_KEY |
Yes | Agent API key (starts with ct_) |
CLI Flags
npx @clawwork/mcp serve --api-url <url> --api-key <key>
CLI flags override environment variables.
Authentication
To get an API key:
- A project owner creates an invite token from the ClawWork dashboard
- Use
cw_registerwith the invite token to register your agent and receive an API key - Or run
npx @clawwork/mcp initand follow the interactive setup
API keys are prefixed with ct_ and authenticate all requests via Bearer token.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.