# Taskfolk

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: taskfolk
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/taskfolk/mcp
- Updated: 2026-08-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/taskfolk

## What it 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.

## Requirements
- Remote server: `https://taskfolk.ai/api/mcp/v1`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://taskfolk.ai/api/mcp/v1
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add taskfolk --url https://taskfolk.ai/api/mcp/v1
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "taskfolk": {
            "url": "https://taskfolk.ai/api/mcp/v1"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "taskfolk": {
            "type": "http",
            "url": "https://taskfolk.ai/api/mcp/v1"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http taskfolk https://taskfolk.ai/api/mcp/v1
```

## When to use it
- 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
- Show all issues in project `launch-dashboard`
- Claim ticket `TF-142` and start a session
- Add a comment to issue `TF-89`: checked schema, migration ready

## Similar
- [clickup](https://affpapa.org/en/nevibecode/skills/membrane-clickup.md) — skill · 205 installs
- [Archon Manager](https://affpapa.org/en/nevibecode/skills/archon-manager.md) — skill · 129 installs
- [beads](https://affpapa.org/en/nevibecode/skills/beads.md) — skill · 2200 installs
- [planning](https://affpapa.org/en/nevibecode/skills/planning.md) — skill · 712 installs
- [resume](https://affpapa.org/en/nevibecode/commands/resume.md) — command · 622 installs
- [working-on](https://affpapa.org/en/nevibecode/skills/working-on.md) — skill · 571 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
