{
  "markdown": "# task-warrior-mcp\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that wraps the [Taskwarrior](https://taskwarrior.org) CLI. Gives Claude (or any MCP client) structured, project-scoped access to your tasks.\n\n## Why project-scoped?\n\nEvery read and write operation requires a `project` field. The server automatically prepends `project:<name>` to all Taskwarrior queries. Without this, a single `task next` call can dump thousands of unrelated tasks into your LLM's context — slow, expensive, and useless. An explicit `all_projects` boolean opt-out exists for the rare cases that genuinely need a global view.\n\n## Requirements\n\n- [Taskwarrior](https://taskwarrior.org/download/) (`task` on `$PATH`)\n\n## Installation\n\n### From MCP Registry (recommended)\n\nFind `task-warrior-mcp` on the [MCP Registry](https://registry.modelcontextprotocol.io) and follow the installation prompt in your MCP client. No build step required.\n\n### From source\n\nRequires [Rust](https://rustup.rs) (stable).\n\n```sh\ngit clone https://github.com/<you>/task-warrior-mcp\ncd task-warrior-mcp\ncargo build --release\n```\n\nThe binary lands at `target/release/task-warrior-mcp`.\n\n## Configuration\n\n### Claude Code (global, all sessions)\n\nIf installed via the MCP registry, your client handles configuration automatically. For a local build:\n\n```sh\nclaude mcp add --scope user taskwarrior /path/to/task-warrior-mcp/target/release/task-warrior-mcp\n```\n\n### Claude Desktop\n\nMerge the snippet below into your `claude_desktop_config.json` (replace `<INSTALL_DIR>` with the absolute path to this repo):\n\n```json\n{\n  \"mcpServers\": {\n    \"taskwarrior\": {\n      \"command\": \"<INSTALL_DIR>/target/release/task-warrior-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n## Tools\n\n| Tool | Required | Optional |\n|---|---|---|\n| `add_task` | `description`, `project` | `due`, `tags`, `priority`, `wait`, `scheduled` |\n| `list_tasks` | `project` | `filter`, `report`, `all_projects` |\n| `search_tasks` | `pattern`, `project` | `filter`, `all_projects` |\n| `get_task` | `id` | — |\n| `modify_task` | `id`, `modifications` | — |\n| `complete_task` | `id` | — |\n| `delete_task` | `id` | — |\n| `annotate_task` | `id`, `note` | — |\n\n### Date syntax\n\n`today` · `tomorrow` · `eow` · `eom` · `friday` · `2025-06-15` · `2025-06-15T14:30` · `today+3d` · `later`\n\n### Filter virtual tags\n\n`+OVERDUE` · `+DUE` · `+TODAY` · `+READY` · `+ACTIVE` · `+BLOCKED` · `+BLOCKING` · `+WAITING`\n\n### Reports\n\n`next` (default, urgency-sorted) · `list` · `all` · `completed` · `waiting` · `blocked`\n\n### Priorities\n\n`H` (high) · `M` (medium) · `L` (low)\n\n## Development\n\n```sh\njust build          # cargo build --release\njust test           # run all tests (each isolated in a temp taskwarrior DB)\njust lint           # clippy + fmt check\n```\n\nOr use cargo directly:\n\n```sh\ncargo test\ncargo clippy\ncargo fmt\n```\n\nA pre-push hook runs fmt + clippy + tests automatically — no setup needed after cloning.\n\nCI runs the same checks on every push and PR via GitHub Actions.\n\n### Releasing\n\nRequires: [`just`](https://github.com/casey/just), [`gh`](https://cli.github.com), `jq`, `openssl`, and [`cargo-edit`](https://github.com/killercup/cargo-edit) (`just setup`).\n\n```sh\njust setup                  # install cargo-edit (one-time)\njust release                # bump patch, build, push tag, create GitHub release, update server.json\njust release minor          # bump minor version\njust release-version 1.2.3  # explicit version\njust publish                # push server.json to the MCP registry (after mcp-publisher login)\n```\n",
  "bytes": 3690,
  "sha": "b0f845e1ece26c9d2dc70b31353bf636c6ba95ffb336e49bea21cd9b85e340ea",
  "repo_slug": "kaierikniermann/taskwarrior-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kaierikniermann_task_warrior_m_77a31728/readme"
}