Benny ChatBenny Docs

Todoist Integration Setup Guide

Task management and productivity

Package: @doist/todoist-api-typescriptView on Smithery

Todoist Integration Setup Guide

The Todoist 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:

  • 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: Configure 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. Click "Configure" or the settings icon
  6. Paste your Todoist API token
  7. Toggle the switch to enable Todoist
  8. Click "Test Connection" to verify the setup
  9. You should see a success message with the number of available tools

Step 3: 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

Connection Test Failed

If the connection test fails:

  1. Verify API Token:
    • Ensure the token has no extra spaces or quotes
    • Token should be exactly as copied from Todoist
  2. Regenerate Token:
  3. Check Account Status:
    • Verify your Todoist account is active
    • Try logging into Todoist web to confirm access

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 Benny Chat's encrypted database
  • 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. Check the Todoist Help Center
  2. Ask Benny Chat for help with specific error messages

Last updated: October 20, 2018 at 1:46 AM