Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: data:read_write.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration. These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

​
Setup

  1. Create a Todoist app: Go to the Todoist App Management console at https://developer.todoist.com/appconsole.html and create a new app.
  2. Configure the OAuth redirect: Set the OAuth redirect URL to your callback (e.g. https://your-app.example.com/api/auth/todoist/callback).
  3. Set environment variables: Copy the Client ID and Client Secret into your .env as TODOIST_CLIENT_ID and TODOIST_CLIENT_SECRET.
  4. Verify access: Connect your Todoist account and run the List Projects tool. A free Todoist account is sufficient for testing.

​
Provider notes

  • Todoist scopes are comma-separated in the authorize URL (e.g. data:read_write). The data:read_write scope covers all tools in this connector.
  • This connector uses the unified Todoist API v1 (api.todoist.com/api/v1); the older REST v2 API is deprecated.
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as todoist__list_tasks with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.