{
  "markdown": "# Todo4 — Claude Code Plugin\n\nTask management for Claude Code. Create, update, and query tasks across sessions via 16 MCP tools backed by [todo4.io](https://todo4.io), plus `/todo4:connect` and `/todo4:status` convenience commands.\n\n## What you get\n\n- **16 MCP tools** — `list_tasks`, `create_task`, `update_task`, `close_task`, `add_subtask`, `add_comment`, `notify_human`, and more. Claude can call these automatically based on your requests.\n- **`/todo4:connect`** — prime the OAuth flow on first install and confirm the session is authenticated.\n- **`/todo4:status`** — a single command that shows overdue tasks, tasks due today, and your top open items ranked by priority.\n- **Cross-session persistence** — tasks live in your Todo4 account, not in local files. They follow you across projects, devices, and agents.\n\n## Install\n\nPick the install path for your client:\n\n### Claude (any client) — recommended\n\nTodo4 works best as a **Custom Connector** — the same setup works in Claude Chat, Cowork, and Desktop:\n\n1. In Claude, go to **Settings → Connectors → Add custom connector**.\n2. Paste URL: `https://todo4.io/mcp`\n3. Click **Connect** — a browser tab opens, you sign in with Todo4 (OAuth creates an account if you don't have one), approve the scopes, and land back in Claude authenticated.\n4. Start using Todo4: ask Claude *\"list my tasks\"*, *\"create a task to review Q2 report by Friday\"*, etc.\n\n> **Tier note:** Custom Connectors require Claude **Pro** or **Max**.\n>\n> **Cowork-specific caveat:** in Cowork only, Custom Connectors may need re-authentication after very long conversations due to a compaction bug ([#34832](https://github.com/anthropics/claude-code/issues/34832)) — just click Connect again if tools stop working.\n\nFor a guided setup with screenshots, see **[todo4.io/setup/cowork](https://todo4.io/setup/cowork)**.\n\n### Claude Code (CLI)\n\nRegister this repo as a plugin marketplace and install the plugin:\n\n```\n/plugin marketplace add panitw/todo4-claude-plugin\n/plugin install todo4@todo4\n```\n\nThen authenticate: run `/mcp`, select `todo4`, and approve the sign-in. Or just call any Todo4 tool — the OAuth tab opens automatically on the 401.\n\n### Cowork plugin install (experimental, not recommended yet)\n\nYou can also install Todo4 as a plugin in Cowork (`Install this Claude Code plugin: https://github.com/panitw/todo4-claude-plugin`), but Cowork specifically has an OAuth bug ([anthropics/claude-code #28695](https://github.com/anthropics/claude-code/issues/28695)) that prevents plugin-supplied MCP servers from authenticating. Use the Custom Connector path above until Anthropic ships the fix.\n\n## Usage\n\nOnce installed, Claude has access to Todo4 tools throughout the session. You can:\n\n- Ask in chat: *\"What's on my plate this week?\"*, *\"Add a task to review the Q2 report by Friday, p2\"*, *\"Close the deploy task and add a note about the rollback.\"*\n- Run the `/todo4:status` slash command for a compact dashboard.\n\n## The tools\n\n| Tool | What it does |\n|------|-------------|\n| `get_platform_info` | Orientation — available tools, tier, timezone, connected agents |\n| `list_tasks` | Paginated task list with status / priority / tag / date filters |\n| `get_task` | Full task details including subtasks, comments, history |\n| `create_task` | Create a single task with duplicate detection |\n| `bulk_create_tasks` | Create up to 20 tasks in one call |\n| `update_task` | Update any field; natural-language due dates |\n| `close_task` | Close with optional completion note |\n| `delete_task` | Soft-delete (recoverable) |\n| `add_subtask` / `complete_subtask` / `list_subtasks` | Checklist items on a task |\n| `list_tags` | All tags currently in use |\n| `add_comment` | Post a comment attributed to the calling agent |\n| `notify_human` | Proactive notification (rate-limited to 1/min) |\n| `list_agents` | Connected AI agents and last activity |\n| `list_attention_items` | Items requiring human attention |\n\n## Requirements\n\n- Claude Code with plugin support\n- A free Todo4 account (created automatically via OAuth on first use)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\n## Author\n\n[Panit Wechasil](https://todo4.io) — feedback & issues welcome in this repo.\n",
  "bytes": 4191,
  "sha": "b42bfe0e7f03e03bb5fe3f43450d6a9dfc3c89e997074d7af4a6b54611c8bccc",
  "repo_slug": "panitw/todo4-claude-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_panitw_todo4_claude_plugin_todo4_e93b4dac/readme"
}