AIエージェントとTodoistをつなぐためのライブラリ。LLMに統合可能なツールが含まれています。 これにより、ユーザーはユーザーの代わりにTodoistアカウントにアクセスし、変更できるようになります。

これらのツールはMCPサーバー経由でも、他のプロジェクトに直接インポートして使用することも可能です。 自分のAI会話インターフェースに統合しましょう。

道具を使って

1.このリポジトリを依存関係として追加してください

2.ツールをインポートしてAIに接続します

こちらはVercelのAI SDKを使った例です。

MCPサーバーとしての使用

クイックスタート

NPXでMCPサーバーを直接実行できます:

セットアップガイド

Todoist MCPサーバーは、さまざまなAIクライアントとの容易な統合を可能にするストリーミング可能なHTTPサービスとして利用可能です:

プライマリURL(ストリーミング可能なHTTP): https://ai.todoist.net/mcp

クロードデスクトップ

1. コネクタ→設定を開く →カスタムコネクタを追加する
2. https://ai.todoist.net/mcpを入力し、OAuth認証を完了します

カーソル

設定ファイルを作成する:

• グローバル: ~/.cursor/mcp.json
• プロジェクト固有: .cursor/mcp.json

その後、コマンドが出たらカーソル設定でサーバーを有効にしてください。

クロードコード(CLI)

最速のセットアップは公式のTodoistプラグインで、MCPサーバーを配線してくれます:

Todoist MCP Server

Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs, enabling them to access and modify a Todoist account on the user’s behalf.

These tools can be used both through an MCP server, or imported directly in other projects to integrate them to your own AI conversational interfaces.

Using tools

1. Add this repository as a dependency

npm install @doist/todoist-mcp

2. Import the tools and plug them to an AI

Here’s an example using Vercel’s AI SDK.

import { findTasksByDate, addTasks } from '@doist/todoist-mcp'
import { TodoistApi } from '@doist/todoist-sdk'
import { streamText } from 'ai'

// Create Todoist API client
const client = new TodoistApi(process.env.TODOIST_API_KEY)

// Helper to wrap tools with the client
function wrapTool(tool, todoistClient) {
    return {
        ...tool,
        execute(args) {
            return tool.execute(args, todoistClient)
        },
    }
}

const result = streamText({
    model: yourModel,
    system: 'You are a helpful Todoist assistant',
    tools: {
        findTasksByDate: wrapTool(findTasksByDate, client),
        addTasks: wrapTool(addTasks, client),
    },
})

Using as an MCP server

Quick Start

You can run the MCP server directly with npx:

npx @doist/todoist-mcp

Setup Guide

The Todoist MCP server is available as a streamable HTTP service for easy integration with various AI clients:

Primary URL (Streamable HTTP): https://ai.todoist.net/mcp

Claude Desktop

1. Open Settings → Connectors → Add custom connector
2. Enter https://ai.todoist.net/mcp and complete OAuth authentication

Cursor

Create a configuration file:

• Global: ~/.cursor/mcp.json
• Project-specific: .cursor/mcp.json

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
        }
    }
}

Then enable the server in Cursor settings if prompted.

Claude Code (CLI)

The fastest setup is the official Todoist plugin, which wires up the MCP server for you:

/plugin marketplace add doist/todoist-mcp
/plugin install todoist@doist

OAuth runs in your browser the first time you use a Todoist tool. See Anthropic’s plugin docs for more.

If you’d rather configure the MCP server manually, run:

claude mcp add --transport http todoist https://ai.todoist.net/mcp

Then launch claude, execute /mcp, and select the todoist MCP server to authenticate.

Visual Studio Code

1. Open Command Palette → MCP: Add Server
2. Select HTTP transport and use:

{
    "servers": {
        "todoist": {
            "type": "http",
            "url": "https://ai.todoist.net/mcp"
        }
    }
}

Other MCP Clients