mcpField
T
tasklist-port

tasklist-port

Local
github.com/CloudCorpRecordsProductivity0Updated 2w ago
Repository

About tasklist-port

tasklist-port is an MCP server and CLI for managing Todoist tasks and core project details through the Todoist REST API v1. It offers a defined subset of task, project, label, and section operations.

Key features

  1. 01Create, update, close, reopen, and delete tasks
  2. 02List and retrieve tasks and projects
  3. 03Create projects and list labels or sections
  4. 04CLI and stdio MCP server

Use cases

  1. 01Manage Todoist tasks from an MCP client
  2. 02Inspect projects, labels, and sections
  3. 03Run Todoist operations from the command line

MCP support

It exposes Todoist task, project, label, and section operations as MCP tools through a stdio server.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "cloudcorprecords-tasklist-port": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/tasklist-port"
      ]
    }
  }
}
Run commandnpx -y @reneturcios/tasklist-port

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@reneturcios/tasklist-port0.1.0
ocighcr.io/cloudcorprecords/tasklist-port:0.1.0

Tools

12

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
labelstringNoOptional label name to filter tasks by.
project_idstringNoOptional identifier of the project to list tasks from.
filter_querystringNoOptional Todoist filter query, sent as the filter parameter, to filter tasks by.

Details

From the project README

tasklist-port

Todoist tasks as MCP tools, talking to the Todoist REST API v1. tasklist-port is a clean-room rebuild of the core surface of the Todoist MCP server, under a new name: fresh code, no copied branding.

Tools (core subset, 12)

list_tasks, get_task, create_task, update_task, close_task, reopen_task, delete_task, list_projects, get_project, create_project, list_labels, list_sections.

Not in this subset: comments, shared labels, collaborators/sharing, reminders, activity log, completed-items history, project collaborators admin, user/productivity stats, Sync API incremental sync, backups, templates import/export, quick-add parsing endpoint.

Setup

Create an API token in Todoist (Settings → Integrations → Developer) and set it:

export TODOIST_API_TOKEN=0123456789abcdef...

Optionally override the API base with TODOIST_API_BASE_URL (default https://api.todoist.com/api/v1). Without the token, every tool call fails with an error naming the missing variable. Note: Todoist list endpoints return either a bare array or a {results:[...]} envelope depending on version — tasklist-port returns the parsed payload as-is.

CLI

npx @reneturcios/tasklist-port list_tasks '{"project_id":"p1"}'
npx @reneturcios/tasklist-port mcp        # stdio MCP server

Each tool name is a subcommand taking one JSON object argument.

MCP client config

{
  "mcpServers": {
    "tasklist-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tasklist-port", "mcp"],
      "env": { "TODOIST_API_TOKEN": "0123456789abcdef..." }
    }
  }
}

Docker

docker run -i -e TODOIST_API_TOKEN ghcr.io/cloudcorprecords/tasklist-port

Development

npm install
npm run build
npm test

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.