Todoist Integration Setup Guide

Task management and productivity

Package: @stevengonsalvez/todoist-mcpView on Smithery

Todoist Integration Setup Guide

The Todoist MCP integration enables Benny Chat to interact with your Todoist tasks, projects, and productivity workflow. This guide will walk you through setting up the integration step by step.

Prerequisites

Before you begin, make sure you have:

  • Completed the Smithery Setup Guide
  • A Todoist account (free or premium)
  • Access to your Todoist settings

Step 1: Get Your Todoist API Token

  1. Log in to your Todoist account
  2. Navigate to Todoist Integrations
  3. Scroll down to the "API token" section
  4. Click "Copy to clipboard" to copy your API token
  5. Important: Keep this token secure and never share it publicly

Step 2: Add Todoist MCP to Your Smithery Profile

  1. Visit the Todoist MCP page on Smithery
  2. Click "Configure" to add it to your profile
  3. Enter the configuration settings:
    • todoistApiToken: Paste your Todoist API token from Step 1
  4. Save the configuration
  5. Test your setup: Click "Connect" on the Todoist MCP page, then use "Explore capabilities" to verify access to your tasks

Step 3: Enable Todoist in Benny Chat

  1. Open Benny Chat and click on your profile icon
  2. Select "Settings" from the dropdown menu
  3. Scroll down to "MCP Tool Settings"
  4. Find "Todoist" in the list of integrations
  5. Toggle the switch to enable Todoist
  6. Click "Test Connection" to verify the setup
  7. You should see a success message with the number of available tools

Step 4: Sync Your Todoist Projects

After a successful connection test:

  1. Click "Sync Projects" button next to the Todoist integration
  2. This will import your Todoist project list into Benny Chat
  3. You'll see a confirmation when the sync is complete

Available Tools

Once configured, you'll have access to the following Todoist tools:

Task Management

  • Create tasks - Add new tasks with due dates, priorities, and projects
  • Update tasks - Modify existing tasks, mark as complete, or reschedule
  • Get tasks - Retrieve tasks by project, label, or filter
  • Delete tasks - Remove tasks from your Todoist

Project Management

  • List projects - View all your Todoist projects
  • Create projects - Add new projects to organize your tasks
  • Update projects - Rename or modify project settings

Labels and Filters

  • Manage labels - Create and apply labels to tasks
  • Use filters - Apply Todoist filters to find specific tasks

Usage Examples

Here are some example prompts you can use with the Todoist integration:

  • "Show me all my tasks due today"
  • "Create a new task to buy groceries tomorrow at 5 PM"
  • "Mark my 'Write report' task as complete"
  • "What tasks do I have in my Work project?"
  • "Add a high priority task to call the dentist"
  • "Show me all tasks labeled as 'urgent'"

Troubleshooting

General Debugging Steps

When debugging Todoist setup:

  1. Test in Smithery first: Use the "Connect" and "Explore capabilities" feature on the Todoist MCP page to verify your configuration
  2. Test any other MCP tool in Benny Chat - if another tool connects, your Smithery API key and Profile ID are correct
  3. If only Todoist fails: The issue is with the Todoist API token configuration

Connection Test Failed

If the connection test fails:

  1. Verify Smithery Setup:
    • Test another MCP integration first
    • If other tools work, your Smithery setup is correct
  2. Check API Token in Smithery:
    • Ensure todoistApiToken has no extra spaces or quotes
    • Token should be exactly as copied from Todoist
  3. Regenerate Token:
  4. Test Connection Again:
    • Try in Smithery first using "Connect" feature
    • Then disable and re-enable in Benny Chat

Project Sync Issues

If projects aren't syncing:

  1. Ensure the connection test passes first
  2. Check that you have projects in your Todoist account
  3. Try clicking "Sync Projects" again after a few seconds
  4. Refresh the Benny Chat page and try again

Tasks Not Appearing

If tasks aren't showing up:

  1. Verify the task exists in your Todoist account
  2. Check if you're using the correct project or filter name
  3. Try a simple command like "Show me all my tasks" first
  4. Make sure your Todoist API token has full access permissions

Best Practices

  1. Sync Projects Regularly: Run project sync when you create new projects in Todoist
  2. Use Natural Language: The integration understands dates like "tomorrow at 3pm" or "next Monday"
  3. Be Specific with Projects: Use exact project names when creating tasks
  4. Leverage Quick Add: You can create multiple tasks in one message
  5. Check Task Details: Ask for task details to see all properties including labels and due dates

Privacy and Security

  • Your Todoist data is accessed only when you explicitly request it
  • API tokens are stored securely in Smithery's encrypted storage
  • Benny Chat retains task data that appears in conversations to maintain context
  • The system does not cache todos outside of serving your conversations
  • Automated daily summaries may make read-only Todoist requests on your behalf
  • Each real-time request ensures you always see current data

API Reference

The Todoist integration uses the official Todoist API v1.

Need Help?

If you encounter issues not covered in this guide:

  1. Review the Smithery Setup Guide
  2. Check the Todoist MCP documentation
  3. Visit the Todoist Help Center
  4. Ask Benny Chat for help with specific error messages

Last updated: September 14, 2025 at 6:38 PM