# Todoist Mcp

> mcp server for todoist

- **Type:** MCP server
- **Install:** `agentstack add mcp-stevengonsalvez-todoist-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [stevengonsalvez](https://agentstack.voostack.com/s/stevengonsalvez)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [stevengonsalvez](https://github.com/stevengonsalvez)
- **Source:** https://github.com/stevengonsalvez/todoist-mcp

## Install

```sh
agentstack add mcp-stevengonsalvez-todoist-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Todoist MCP Server

[](https://smithery.ai/server/@stevengonsalvez/todoist-mcp)

A Model Context Protocol (MCP) server for Todoist, enabling advanced task and project management via Claude Desktop and other MCP-compatible clients.

## Requirements
- Node.js (v18 or higher recommended)
- npm or yarn
- A Todoist account
- A Todoist API token (see https://todoist.com/prefs/integrations)

## Features
- List, create, update, complete, reopen, and delete tasks
- List, create, update, archive, unarchive, and delete projects
- List, create, update, and delete sections
- List, create, update, and delete labels
- List, create, update, and delete comments
- Manage shared labels
- Fetch project collaborators

## All Features
- **Tasks**: List, get, create, update, complete, reopen, delete
- **Projects**: List, get, create, update, archive, unarchive, delete
- **Sections**: List (by project), get, create, update, delete
- **Labels**: List, get, create, update, delete, manage shared labels
- **Comments**: List (by task/project), get, create, update, delete
- **Collaborators**: List project collaborators

## Installation

### For Claude Desktop (JSON)
If published as an npm package, you can use it directly with npx in your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}
```
- Set the `TODOIST_API_TOKEN` as shown.

### Manual Installation
1. Clone the repository:
   ```sh
   git clone https://github.com/yourusername/todoist-mcp.git
   cd todoist-mcp
   ```
2. Install dependencies:
   ```sh
   npm install
   # or
   yarn install
   ```
3. Build the project:
   ```sh
   npm run build
   # or
   yarn build
   ```
4. Set your Todoist API token as an environment variable (see above).
5. Run the built server:
   ```sh
   node dist/server.js
   ```
6. Configure Claude Desktop to use your local build by adding this to your config file:
   ```json
   {
     "mcpServers": {
       "todoist": {
         "command": "node",
         "args": [
           "/path/to/todoist-mcp/dist/server.js"
         ],
         "env": {
           "TODOIST_API_TOKEN": "your_todoist_token"
         }
       }
     }
   }
   ```

## Usage Examples
- **Get top priority tasks:**
  > "Show me my top priority tasks."
- **Create and classify labels:**
  > "Create labels for my tasks and classify them by project or urgency."
- **Organize tasks by section:**
  > "Move all tasks with the label 'urgent' to the 'Today' section."
- **Project management:**
  > "Create a new project called 'Personal Growth' and add a section 'Reading List'."
- **Collaborator overview:**
  > "List all collaborators for the project 'Team Launch'."
- **Comment management:**
  > "Add a comment to the task 'Prepare slides' with the content 'Remember to include Q2 results.'"

## License
This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [stevengonsalvez](https://github.com/stevengonsalvez)
- **Source:** [stevengonsalvez/todoist-mcp](https://github.com/stevengonsalvez/todoist-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-stevengonsalvez-todoist-mcp
- Seller: https://agentstack.voostack.com/s/stevengonsalvez
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.