Content
<div align="center">
<img src="https://img.icons8.com/color/200/todoist.png" width="120"/>
<h1>Todoist MCP Server</h1>
<p>A Model Context Protocol (MCP) server implementation that integrates Claude and other AI assistants with Todoist, enabling natural language task management.</p>
<div>
<img src="https://img.shields.io/badge/claude-mcp-blue" alt="MCP Server">
<img src="https://img.shields.io/badge/todoist-mcp-orange" alt="Todoist Integration">
<a href="https://www.npmjs.com/package/todoist-mcp" target="_blank">
<img src="https://img.shields.io/npm/v/todoist-mcp.svg" alt="npm version">
</a>
</div>
</div>
## Features
- **Complete Todoist API Integration**: Access to the full Todoist REST API v2, and support for the Todoist Sync API through natural language
- **Batch Processing**: Client can process multiple tasks in a single request
- **Search by name**: AI can search for tasks, projects, and labels by name instead of ID
- **Tasks**: Create, update, close, reopen, move, and delete tasks using conversational language
- **Projects**: Create and manage projects and sections
- **Comments**: Add and manage comments on tasks and projects
- **Labels**: Create and manage personal and shared labels
- **Prompt Support**: You can easily provide information about your projects to client
## Configuration
You'll need a Todoist API token to use this MCP server.
### Getting a Todoist API Token
1. Log in to your Todoist account
2. Navigate to Settings → Integrations
3. Find your API token under "Developer"
### Usage with Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "todoist-mcp"],
"env": {
"API_KEY": "your_todoist_api_token_here"
}
}
}
}
```
## Available Tools
### Tasks
- `get_tasks_list`: Get tasks with optional filtering by project, section, label, etc.
- `create_tasks`: Create new tasks with various attributes
- `get_tasks`: Get specific tasks by ID or name
- `update_tasks`: Update existing tasks
- `close_tasks`: Mark tasks as complete
- `reopen_tasks`: Reopen completed tasks
- `delete_tasks`: Delete tasks
- `move_tasks`: Move tasks to a different project or section
### Projects
- `get_projects_list`: Get all projects
- `create_projects`: Create new projects
- `get_projects`: Get specific projects by ID or name
- `update_projects`: Update existing projects
- `delete_projects`: Delete projects
- `get_collaborators`: Get all collaborators for a project
- `move_projects`: Move projects to a different location or subproject
### Sections
- `get_sections_list`: Get all sections or filter by project
- `create_sections`: Create new sections
- `get_sections`: Get specific sections by ID or name
- `update_sections`: Update sections
- `delete_sections`: Delete sections
### Comments
- `get_comments_list`: Get comments for a project or task
- `create_comments`: Create new comments
- `get_comments`: Get specific comments by ID
- `update_comments`: Update comments
- `delete_comments`: Delete comments
### Labels
- `get_labels_list`: Get all personal labels
- `create_labels`: Create new personal labels
- `get_labels`: Get personal labels by ID or name
- `update_labels`: Update personal labels
- `delete_labels`: Delete personal labels
- `get_shared_labels`: Get all shared labels
- `rename_shared_labels`: Rename shared labels
- `remove_shared_labels`: Remove shared labels
### Utils
- `utils_get_colors`: Get available colors for projects, labels, filters
## Prompts
- `projects_list`: Get list of projects with their sections and params in markdown format
## Example Usage
Ask your AI assistant (like Claude) questions such as:
```
"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"
```
## Development
```bash
# Install dependencies
npm install
# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.
## Issues and Support
If you encounter any issues or need support, please file an issue on the GitHub repository.
<a href="https://glama.ai/mcp/servers/@stanislavlysenko0912/todoist-mcp-server">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@stanislavlysenko0912/todoist-mcp-server/badge" />
</a>
Connection Info
You Might Also Like
Time
Obtaining current time information and converting time between different...
bytebot
Bytebot is a self-hosted AI desktop agent that automates computer tasks...
inbox-zero
The world's best AI personal assistant for email. Open source app to help...
DesktopCommanderMCP
This is MCP server for Claude that gives it terminal control, file system...
ClaudeComputerCommander
This is an MCP server that provides terminal control, file system search,...
astron-rpa
Agent-ready RPA suite with out-of-the-box automation tools. Built for...