English Français العربية

io.github.CloudCorpRecords/tasklist-port

السجل الرسمي أخرى

Todoist tasks, projects, labels and sections as MCP tools.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @reneturcios/tasklist-port
Claude Code 
claude mcp add tasklist-port -- npx -y @reneturcios/tasklist-port@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "tasklist-port": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/tasklist-port@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/tasklist-port:0.1.0
Claude Code 
claude mcp add tasklist-port -- docker run -i --rm ghcr.io/cloudcorprecords/tasklist-port:0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "tasklist-port": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/tasklist-port:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. tasklist-port
  2. Tools (core subset, 12)
  3. Setup
  4. CLI
  5. MCP client config
  6. Docker
  7. Development
  8. License

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

الأسئلة الشائعة

ما هو io.github.CloudCorpRecords/tasklist-port؟

Todoist tasks, projects, labels and sections as MCP tools.

كيف أثبّت io.github.CloudCorpRecords/tasklist-port؟

يعمل على جهازك. في Claude Code: claude mcp add tasklist-port -- npx -y @reneturcios/tasklist-port@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/tasklist-port إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/tasklist-port مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CloudCorpRecords/tasklist-port؟

ينشره CloudCorpRecords. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.