Todoist MCP

How to Install and Use Todoist MCP

If you want to connect your AI model to Todoist using Model Context Protocol, you can use Todoist MCP. This tool helps you interact with Todoist by managing tasks, projects, labels, and more. Here’s a simple guide on how to install and use Todoist MCP with easy examples.

Step 1: Build the Server App

Before using Todoist MCP, you need to set it up on your computer. First, open your command line or terminal and go to the folder where you want to install Todoist MCP. Then, you will run these commands one by one. These commands will download everything needed and build the program.

npm install
npm run build

The first command installs all the necessary code libraries. The second command creates the files needed to run the server.

Step 2: Get Your Todoist API Key

To connect Todoist MCP with your Todoist account, you need an API key. This key is like a password that lets Todoist MCP access your tasks and projects safely.

To get your API key:

• Open Todoist
• Go to Settings
• Click on Integrations
• Find Developer section
• Copy the API key

Step 3: Configure Todoist MCP for Claude

Todoist MCP works well with Claude, an AI app that supports MCP servers. You must tell Claude where your Todoist MCP server is and provide your API key. You do this by editing a file named claude_desktop_config.json.

Add this section to your config file, replacing /path/to/repo/build/index.js with the actual path where you built Todoist MCP and "your_todoist_api_key" with the key you copied:

{
  "mcpServers": {
    "todoist-mcp": {
      "command": "node",
      "args": ["/path/to/repo/build/index.js"],
      "env": {
        "TODOIST_API_KEY": "your_todoist_api_key"
      }
    }
  }
}

This setup tells Claude how to start Todoist MCP and use the API key.

Step 4: Run Todoist MCP with Claude

Now, launch the Claude desktop app. With Todoist MCP connected, you can ask Claude to manage your Todoist items. For example, you can tell it to create tasks, update projects, or get information about your to-dos.

Optional: Install with Smithery CLI

If you want an easier way to install Todoist MCP, you can use Smithery, a tool for installing servers.

Open your terminal and run this command:

npx -y @smithery/cli install @miottid/todoist-mcp --client claude

This command downloads and sets up Todoist MCP for Claude automatically.

---

By following these steps, you get Todoist MCP up and running. You’ll be able to use an AI assistant like Claude to handle your Todoist tasks and projects easily.