All integrations

Todoist

Tasks, projects, and labels for personal productivity. Not created by, affiliated with, or supported by Doist.

OAuth 14 tools

Overview

Connect Todoist to give AI clients access to your tasks, projects, labels, and comments for personal productivity.

This integration is not created by, affiliated with, or supported by Doist.

Prerequisites

  • A Todoist account with tasks and projects you want AI to access
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai.
  2. Go to Integrations and open Todoist.
  3. Click Activate, then Connect Todoist.
  4. Approve the OAuth prompt — stackgate.ai stores your Todoist token securely.

No manual API keys are required.

Using with AI clients

  • Dedicated endpoint: POST /mcp/todoist with a Sanctum bearer token
  • Private gateway: one config for all integrations — use todoist__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete the OAuth connect flow in My Integrations.
  • Allow access does nothing on Todoist — in the Todoist App Console, add this exact redirect URI under your Stackgate.ai app: https://mcp-center.test/oauth/todoist/callback (or your production URL). It must match TODOIST_REDIRECT_URI character-for-character.
  • Redirected back but shows “Could not connect to Todoist” — the OAuth callback failed after Todoist returned; disconnect, try again, and check storage/logs/laravel.log for Todoist OAuth callback failed.
  • 401 unauthorized from Todoist — disconnect and reconnect Todoist from the integration page (access tokens expire after about an hour).
  • 429 too many requests — wait and retry; Todoist may include a retry hint in the error response.

Available tools

  • list-projects-tool

    List Todoist projects for the connected account.

  • get-project-tool

    Get a Todoist project by ID.

  • list-sections-tool

    List Todoist sections, optionally filtered by project.

  • list-labels-tool

    List personal labels for the connected Todoist account.

  • list-tasks-tool

    List active Todoist tasks with optional filters by project, section, label, or parent task.

  • get-task-tool

    Get full details for a Todoist task by ID.

  • create-task-tool

    Create a new Todoist task.

  • update-task-tool

    Update fields on an existing Todoist task. Only provided fields are changed.

  • close-task-tool

    Mark a Todoist task as complete.

  • reopen-task-tool

    Reopen a completed Todoist task.

  • move-task-tool

    Move a Todoist task to another project, section, or parent task.

  • delete-task-tool

    Permanently delete a Todoist task. Requires data:delete OAuth scope.

  • list-comments-tool

    List comments on a Todoist task or project.

  • create-comment-tool

    Add a comment to a Todoist task or project.

MCP endpoint: https://stackgate.ai/mcp/todoist (HTTP) or via the private gateway.