@groo.dev/tasks-mcp

MCP server for Groo Tasks - a lightweight task tracking system for developers.

Usage Options

Option 1: Hosted Server (Recommended)

No installation required. Connect directly to the hosted MCP server:

{
  "mcpServers": {
    "groo-tasks": {
      "url": "https://tasks.groo.dev/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

Option 2: Local Process (stdio)

Run as a local process via npx:

{
  "mcpServers": {
    "groo-tasks": {
      "command": "npx",
      "args": ["@groo.dev/tasks-mcp"],
      "env": {
        "GROO_AUTH_TOKEN": "YOUR_PAT_TOKEN"
      }
    }
  }
}

Testing

Test with MCP Inspector:

GROO_AUTH_TOKEN=your_token npx @modelcontextprotocol/inspector npx @groo.dev/tasks-mcp

Or pipe JSON-RPC directly:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | \
GROO_AUTH_TOKEN=your_token npx @groo.dev/tasks-mcp

Tools

| Tool | Description | |------|-------------| | list_projects | List available projects | | list_tasks | List tasks with optional filters (project, status, priority) | | search_tasks | Search tasks by keyword | | get_task | Get task details with comments | | create_task | Create a new task | | update_task | Update task properties | | start_task | Mark task as in_progress | | complete_task | Mark task as done | | archive_task | Archive a task | | add_comment | Add comment to a task |

Resources

| Resource | URI | Description | |----------|-----|-------------| | Open Tasks | tasks://open | Tasks ready to work on | | In Progress | tasks://in-progress | Currently active tasks |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GROO_AUTH_TOKEN | Yes | Personal Access Token (PAT) | | TASKS_API_URL | No | API URL (default: https://tasks.groo.dev) |

License

MIT