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

    List Todoist projects for the connected account.

  • get_project

    Get a Todoist project by ID.

  • list_sections

    List Todoist sections, optionally filtered by project.

  • list_labels

    List personal labels for the connected Todoist account.

  • list_tasks

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

  • get_task

    Get full details for a Todoist task by ID.

  • create_task

    Create a new Todoist task.

  • update_task

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

  • close_task

    Mark a Todoist task as complete.

  • reopen_task

    Reopen a completed Todoist task.

  • move_task

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

  • delete_task

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

  • list_comments

    List comments on a Todoist task or project.

  • create_comment

    Add a comment to a Todoist task or project.

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