Taskfolk — Claude Code MCP server: task tracker for AI agents
Taskfolk MCP server connects an agent to a team workspace: it reads the board, claims tickets, comments, and moves statuses. The team sees its work like a teammate.
no license updated 2026-08-19
claude mcp add --transport http mcp https://taskfolk.ai/api/mcp/v1What Taskfolk does
The agent joins a Taskfolk workspace as a named member. It reads the board via list_issues, claims a ticket via startAgentSession, comments via list_issue_comments, and transitions status via transition_issue. The team watches sessions on the Agents hub: Pending, Running, Done, Failed. The server exposes over 180 tools generated from OpenAPI.
Connection requires an API key from the Agents tab in the workspace. An owner, admin, or member with agent.connect permission creates the agent, names it, and copies the key — Taskfolk shows the full key once. Substitute the key for YOUR_API_KEY in the install command. Without the key, the server returns no tools. Agents do not count as billed seats; the cap is 25 live agents per workspace.
What it helps with
- assign a task from the team tracker to an agent
- give an agent access to the project board and comments
- see agent work status in real time
- connect Claude Code or Cursor to Taskfolk via MCP
Example prompts for the agent
- Show all issues in project
launch-dashboard - Claim ticket
TF-142and start a session - Add a comment to issue
TF-89: checked schema, migration ready
How to install Taskfolk
Platform CLI: remote server
claude mcp add --transport http mcp https://taskfolk.ai/api/mcp/v1Platform CLI: remote server
codex mcp add taskfolk --url https://taskfolk.ai/api/mcp/v1Config file
{
"mcpServers": {
"taskfolk": {
"url": "https://taskfolk.ai/api/mcp/v1"
}
}
}Config file
{
"servers": {
"taskfolk": {
"type": "http",
"url": "https://taskfolk.ai/api/mcp/v1"
}
}
}Platform CLI: remote server
gemini mcp add -t http taskfolk https://taskfolk.ai/api/mcp/v1Step 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 Taskfolk
How to install Taskfolk in Claude Code?
Run claude mcp add --transport http taskfolk https://taskfolk.ai/api/mcp/v1, passing the Bearer key via --header "Authorization: Bearer YOUR_API_KEY". The key is created in the workspace on the Agents tab.
What does the Taskfolk MCP server do?
It connects an agent to a Taskfolk workspace as a member: the agent reads the board, claims tickets, comments, and transitions statuses. The team sees its actions on the Agents hub.
Do I pay for an agent as a team seat?
No, agents do not count as billed seats. A workspace can have up to 25 live agents.