https://github.com/stanislavlysenko0912/todoist-mcp-server
Full implementation of Todoist Rest API for MCP server
https://github.com/stanislavlysenko0912/todoist-mcp-server
Last synced: 14 days ago
JSON representation
Full implementation of Todoist Rest API for MCP server
- Host: GitHub
- URL: https://github.com/stanislavlysenko0912/todoist-mcp-server
- Owner: stanislavlysenko0912
- License: mit
- Created: 2025-03-29T16:13:53.000Z (18 days ago)
- Default Branch: main
- Last Pushed: 2025-03-29T17:44:35.000Z (18 days ago)
- Last Synced: 2025-03-29T18:32:42.894Z (18 days ago)
- Language: TypeScript
- Homepage:
- Size: 26.4 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-mcp-servers - Todoist - Task management platform API integration (👥 Community Contributions / Productivity & Knowledge Management)
- awesome-mcp-servers - Todoist - Task management platform API integration (👥 Community Contributions / Productivity & Knowledge Management)
- awesome-mcp-servers - Todoist - Full implementation of Todoist Rest API & support Todoist Sync API for MCP server (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - Todoist - Full implementation of Todoist Rest API & support Todoist Sync API for MCP server (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - Todoist - Full implementation of Todoist Rest API for MCP server (Community Servers)
README
Todoist MCP Server
A Model Context Protocol (MCP) server implementation that integrates Claude and other AI assistants with Todoist, enabling natural language task management.
## 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.
