todoist

This MCP server serves as a connector between Claude and Todoist, enabling you to manage tasks, projects, sections, comments, and labels directly from natural language conversations. After you connect your Todoist account via OAuth and copy your personal connector URL, you can integrate it with Claude by adding a Custom Integration named Todoist and pointing Claude to your connector URL. Claude can then invoke a variety of tools to perform CRUD operations on tasks, projects, sections, and associated metadata.

Available tools include task management (get_tasks, create_task, update_task, complete_task, uncomplete_task), project organization (list_projects, create_project, update_project, delete_project, get_sections, create_section), and comments/labels (get_comments, create_comment, get_labels, create_label). Each tool is designed to return structured data Claude can interpret, enabling seamless task management within your conversations. You can filter tasks, assign due dates and priorities, manage project structures, and add context with comments and labels without leaving Claude.

Prerequisites:

• Node.js (recommended LTS) installed on your system
• Git to clone the repository (if you have access to the source)
• An active Todoist account for OAuth authentication

Installation steps:

1. Clone the repository (or download the package): git clone https://github.com/rosenpin/ro senpin-todoist-mcp-server.git cd rosenpin-todoist-mcp-server

2. Install dependencies: npm install

3. Configure environment variables:

   • Create a .env file or set environment variables in your hosting environment with: OAUTH_CLIENT_ID=your_todoist_oauth_client_id OAUTH_CLIENT_SECRET=your_todoist_oauth_client_secret OAUTH_REDIRECT_URI=https://your-domain.com/oauth/callback TODOIST_APP_TOKEN=optional_todoist_api_token

4. Run the server locally for testing: node server.js

5. Deploy to your preferred environment (cloud VM, container, or platform as a service) and ensure the OAuth redirect is accessible publicly so Todoist can redirect back after authentication.

6. In Claude, connect the Personal Connector URL from the running server to enable the Todoist integration.

Tips and potential issues:

• Ensure your OAuth redirect URI is correctly configured in Todoist and matches what your server expects.
• If you rotate OAuth client credentials, update the environment variables accordingly and restart the server.
• The connector relies on Todoist API access; if you encounter rate limiting, consider batching requests or adding appropriate delay handling in your workflow.
• Use secure storage for your OAuth tokens and never commit secret keys to version control.
• Verify that the server's public URL is reachable by Claude, and that any firewalls allow incoming connections from Claude's IPs if required.