https://github.com/doist/todoist-mcp
Deprecated. See: Doist/todoist-ai
https://github.com/doist/todoist-mcp
Last synced: 3 days ago
JSON representation
Deprecated. See: Doist/todoist-ai
- Host: GitHub
- URL: https://github.com/doist/todoist-mcp
- Owner: Doist
- License: mit
- Archived: true
- Created: 2025-02-11T14:39:39.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-09-16T07:38:06.000Z (21 days ago)
- Last Synced: 2025-10-05T01:03:31.134Z (3 days ago)
- Language: TypeScript
- Homepage: https://www.todoist.com
- Size: 361 KB
- Stars: 176
- Watchers: 9
- Forks: 47
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!IMPORTANT]
> **Deprecation Notice**: This repository is deprecated.
>
> Doist now maintains the official Todoist MCP tools in the new repository:
[Doist/todoist-ai](https://github.com/Doist/todoist-ai). Please migrate to the new tools for continued support and updates.
>
> More details [here](https://github.com/Doist/todoist-mcp/discussions/103).
# Todoist MCP
Connect this [Model Context Protocol](https://modelcontextprotocol.io/introduction) server to your LLM to interact with Todoist.
## Functionality
This integration implements all the APIs available from the [Todoist TypeScript Client](https://doist.github.io/todoist-api-typescript/api/classes/TodoistApi/), providing access to:
### Task Management
- Create tasks (with content, descriptions, due dates, priorities, labels, and more)
- Create tasks with natural language (e.g., "Submit report by Friday 5pm #Work")
- Retrieve tasks (individual, filtered, or all tasks)
- Retrieve completed tasks (by completion date or due date)
- Get productivity statistics
- Update tasks
- Move tasks (individually or in batches)
- Close/reopen tasks
- Delete tasks
### Project Management
- Create, retrieve, update, and delete projects
### Section Management
- Create, retrieve, update, and delete sections within projects
### Comment Management
- Add, retrieve, update, and delete comments for tasks or projects
### Label Management
- Create, retrieve, update, and delete labels
- Manage shared labels
### Collaboration
- Get collaborators for projects
## Setup
**Build the server app:**
```
npm install
npm run build
```
**Configure Claude:**
You must install the [Claude](https://claude.ai/) desktop app which supports MCP.
You can get your Todoist API key from [Todoist > Settings > Integrations > Developer](https://app.todoist.com/app/settings/integrations/developer).
Then, in your `claude_desktop_config.json`, add a new MCP server:
```
{
"mcpServers": {
"todoist-mcp": {
"command": "node",
"args": ["/path/to/repo/build/index.js"],
"env": {
"TODOIST_API_KEY": "your_todoist_api_key"
}
}
}
}
```
You can now launch Claude desktop app and ask to update Todoist.
## Distribution
### Smithery
[](https://smithery.ai/server/@miottid/todoist-mcp)
Install Todoist MCP on Claude Desktop using [Smithery](https://smithery.ai/server/@miottid/todoist-mcp):
```bash
npx -y @smithery/cli install @miottid/todoist-mcp --client claude
```
### Glama
