Taskqueue MCP Server

Task Queue MCP Server

Local serverstdio

What is the Taskqueue MCP server?

If you already use Taskqueue, the taskqueue mcp server is the piece that lets your assistant work with it directly. Task Queue MCP Server.

What the server does

MCP Task Manager (npm package: taskqueue-mcp) is a Model Context Protocol (MCP) server for AI task management. This tool helps AI assistants handle multi-step tasks in a structured way, with optional user approval checkpoints.

  • Task planning with multiple steps
  • Progress tracking
  • User approval of completed tasks
  • Project completion approval
  • Task details visualization
  • Task status state management

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • list_projects — Lists all projects in the system
  • read_project — Gets details about a specific project
  • create_project — Creates a new project with initial tasks
  • delete_project — Removes a project
  • add_tasks_to_project — Adds new tasks to an existing project
  • finalize_project — Finalizes a project after all tasks are done
  • list_tasks — Lists all tasks for a specific project
  • read_task — Gets details of a specific task
  • create_task — Creates a new task in a project
  • update_task — Modifies a task's properties (title, description, status)
  • delete_task — Removes a task from a project
  • approve_task — Approves a completed task

Credentials and setup notes

Configuration is passed through the environment: OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, DEEPSEEK_API_KEY, TASK_MANAGER_FILE_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

The server ships on npm as taskqueue, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Taskqueue's toolset — list_projects, read_project, create_project and 11 more — is a fair guide to whether it matches your workflow. It is maintained by chriscarrollsmith; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Taskqueue's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Taskqueue.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
list_projectsLists all projects in the system
read_projectGets details about a specific project
create_projectCreates a new project with initial tasks
delete_projectRemoves a project
add_tasks_to_projectAdds new tasks to an existing project
finalize_projectFinalizes a project after all tasks are done
list_tasksLists all tasks for a specific project
read_taskGets details of a specific task
create_taskCreates a new task in a project
update_taskModifies a task's properties (title, description, status)
delete_taskRemoves a task from a project
approve_taskApproves a completed task
get_next_taskGets the next pending task in a project
mark_task_doneMarks a task as completed with details

How to install the Taskqueue MCP server

{
  "mcpServers": {
    "taskqueue": {
      "command": "npx",
      "args": ["-y", "taskqueue"],
      "env": {
        "OPENAI_API_KEY": "your-value",
        "GOOGLE_GENERATIVE_AI_API_KEY": "your-value",
        "DEEPSEEK_API_KEY": "your-value",
        "TASK_MANAGER_FILE_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
OPENAI_API_KEYCredential the server authenticates with.Yes
GOOGLE_GENERATIVE_AI_API_KEYCredential the server authenticates with.Yes
DEEPSEEK_API_KEYCredential the server authenticates with.Yes
TASK_MANAGER_FILE_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Taskqueue to list projects.
  • Use Taskqueue to read project.
  • Use Taskqueue to create project.

Frequently asked questions

It connects Taskqueue to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (list_projects, read_project, create_project, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Taskqueue directly.