TaskQ MCP Server

MCP (Model Context Protocol) server for TaskQ task management API. Enables Claude Code and other MCP-compatible tools to manage tasks, projects, queues and notifications in TaskQ.

Installation

npm install -g @taskq_mcp/server

Or use directly with npx:

npx @taskq_mcp/server

Configuration

Add the MCP server configuration to your .mcp.json:

Using npx (recommended)

{
  "mcpServers": {
    "taskq": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@taskq_mcp/server"],
      "env": {
        "TASKQ_URL": "https://api.taskq.ru",
        "TASKQ_TOKEN": "tq_your_token"
      }
    }
  }
}

Using global install

{
  "mcpServers": {
    "taskq": {
      "type": "stdio",
      "command": "taskq-mcp-server",
      "env": {
        "TASKQ_URL": "https://api.taskq.ru",
        "TASKQ_TOKEN": "tq_your_token"
      }
    }
  }
}

Environment variables

| Variable | Description | Default | |---|---|---| | TASKQ_URL | TaskQ API URL | http://localhost:8080 | | TASKQ_TOKEN | API token for authorization | required |

Getting an API token

1. Log in to TaskQ web interface
2. Go to Profile -> API keys
3. Click Create key, set a name
4. Copy the generated token (starts with tq_)

The token is passed in the Authorization: Bearer tq_... header.

Available tools

Projects

| Tool | Description | |---|---| | list_projects | List user's projects (search, pagination) | | get_project | Project details | | create_project | Create a project | | update_project | Update a project | | get_project_participants | Project participants with roles | | get_project_stages | Project kanban board stages | | get_project_analytics | Project analytics (tasks by status, priority) |

Tasks

| Tool | Description | |---|---| | list_tasks | List tasks with filters (project, status, priority, assignee, labels, dates, search) | | get_task | Full task details | | create_task | Create a task | | update_task | Update task fields | | delete_task | Delete a task | | archive_task | Archive a task | | unarchive_task | Unarchive a task | | bulk_task_action | Bulk actions (status change, assign, priority, delete) | | get_task_activity | Task change log |

Comments

| Tool | Description | |---|---| | list_comments | Task comments | | add_comment | Add a comment (markdown) | | update_comment | Edit a comment | | delete_comment | Delete a comment |

Queue

| Tool | Description | |---|---| | get_queue | User's task queue with ETA calculation | | reorder_queue | Reorder a task in the queue |

Notifications

| Tool | Description | |---|---| | list_notifications | List notifications (filter by read status) | | get_unread_count | Unread notifications count | | mark_notification_read | Mark notification as read | | mark_all_notifications_read | Mark all notifications as read |

Users & Search

| Tool | Description | |---|---| | get_me | Current user profile | | search | Global search across tasks, projects and users | | list_labels | List available labels |

Usage examples

After configuring .mcp.json, tools are available automatically in Claude Code.

List project tasks:

Show all tasks for project with ID 5

Create a task:

Create a bug "Auth error" in project 3 with critical priority assigned to users 10 and 12

Check queue:

What's my task queue and ETA?

Find a task:

Find task PROJ-42

License

MIT