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
- Log in to your Todoist account
- Navigate to Todoist Integrations
- Scroll down to the "API token" section
- Click "Copy to clipboard" to copy your API token
- Important: Keep this token secure and never share it publicly
Step 2: Add Todoist MCP to Your Smithery Profile
- Visit the Todoist MCP page on Smithery
- Click "Configure" to add it to your profile
- Enter the configuration settings:
todoistApiToken
: Paste your Todoist API token from Step 1
- Save the configuration
- 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
- Open Benny Chat and click on your profile icon
- Select "Settings" from the dropdown menu
- Scroll down to "MCP Tool Settings"
- Find "Todoist" in the list of integrations
- Toggle the switch to enable Todoist
- Click "Test Connection" to verify the setup
- You should see a success message with the number of available tools
Step 4: Sync Your Todoist Projects
After a successful connection test:
- Click "Sync Projects" button next to the Todoist integration
- This will import your Todoist project list into Benny Chat
- 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:
- Test in Smithery first: Use the "Connect" and "Explore capabilities" feature on the Todoist MCP page to verify your configuration
- Test any other MCP tool in Benny Chat - if another tool connects, your Smithery API key and Profile ID are correct
- If only Todoist fails: The issue is with the Todoist API token configuration
Connection Test Failed
If the connection test fails:
- Verify Smithery Setup:
- Test another MCP integration first
- If other tools work, your Smithery setup is correct
- Check API Token in Smithery:
- Ensure
todoistApiToken
has no extra spaces or quotes - Token should be exactly as copied from Todoist
- Ensure
- Regenerate Token:
- Get a new API token from Todoist Settings
- Update it in Smithery configuration
- 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:
- Ensure the connection test passes first
- Check that you have projects in your Todoist account
- Try clicking "Sync Projects" again after a few seconds
- Refresh the Benny Chat page and try again
Tasks Not Appearing
If tasks aren't showing up:
- Verify the task exists in your Todoist account
- Check if you're using the correct project or filter name
- Try a simple command like "Show me all my tasks" first
- Make sure your Todoist API token has full access permissions
Best Practices
- Sync Projects Regularly: Run project sync when you create new projects in Todoist
- Use Natural Language: The integration understands dates like "tomorrow at 3pm" or "next Monday"
- Be Specific with Projects: Use exact project names when creating tasks
- Leverage Quick Add: You can create multiple tasks in one message
- 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:
- Review the Smithery Setup Guide
- Check the Todoist MCP documentation
- Visit the Todoist Help Center
- Ask Benny Chat for help with specific error messages