Todoist Connector

Connect Zenmako to Todoist to query and manage your tasks. This enables AI to retrieve tasks with various filters, helping you stay organized and track your to-dos.

Getting Your API Token

Todoist uses API tokens for authentication. Follow these steps to get yours:

  • Log in to Todoist
  • Click your profile icon in the top-right corner
  • Select Settings
  • Navigate to Integrations in the left sidebar
  • Scroll down to the Developer section
  • Copy your API token

    • Store your token securely. The token provides full access to your Todoist account data.

    Connecting Todoist

  • Navigate to the Connections page in Zenmako
  • Click Add Connection and select Todoist
  • Enter your credentials:
    • - API Token: Paste the API token you copied from Todoist settings
  • Click Save
  • Click Test Connection to verify the setup works

    • If the test succeeds, your Todoist connection is ready to use.

    Available Actions

    ActionDescription
    getTasksGet tasks from Todoist with optional filters (project_id, section_id, label, filter)

    Filter Parameters

    The getTasks action supports several filter options:

  • project_id: Filter tasks by a specific project
  • section_id: Filter tasks by a specific section within a project
  • label: Filter tasks by label name
  • filter: Use Todoist's filter syntax (e.g., "today", "overdue", "priority 1")

    • Example Prompts

    Try these prompts to interact with your Todoist data:

  • "Show me all my Todoist tasks"
  • "What tasks do I have due today in Todoist?"
  • "List all my overdue tasks from Todoist"
  • "Show me all tasks with the 'work' label"
  • "What high-priority tasks do I have in Todoist?"

    • Common Issues

    "Todoist API error: 401 Unauthorized"

    This means your API token is invalid or has been regenerated. Solutions:

  • Verify you copied the complete token without extra spaces
  • Check if you recently regenerated your API token in Todoist settings
  • Copy a fresh token from Todoist and update your connection

    • Tasks not appearing in results

    If you expect tasks but get empty results, check your filters:

  • Verify the project_id or section_id is correct
  • Ensure the label name matches exactly (case-sensitive)
  • Test without filters first to confirm the connection works