Skip to main content
Glama

MCP Todoist

by kentaroh7777
GitHub
TypeScript
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Todoist

Todoist API互換のMCPサーバー実装

技術スタック

  • フロントエンド: Next.js 14 (App Router)
  • UI: Ant Design + Tailwind CSS
  • バックエンド: Convex
  • 言語: TypeScript
  • API: MCP (Model Context Protocol)

アーキテクチャ

├── フロントエンド (Next.js 14) │ ├── React Server Components │ ├── Client Components │ └── API Routes ├── MCP Server Layer │ ├── Protocol Handler │ ├── Todoist API Adapter │ └── Tool Registry ├── バックエンド (Convex) │ ├── Database Functions │ ├── Mutations │ ├── Queries │ └── Actions └── 外部API └── Todoist API

主要機能

実装済み

  • プロジェクト基本構成
  • Next.js 14 + TypeScript セットアップ
  • Ant Design UIコンポーネント
  • MCP Server基本実装
  • Todoist APIクライアント
  • データスキーマ定義
  • 環境変数設定管理
  • MCPツール実装（サンプルデータ対応）
  • テストUIコンポーネント
  • APIエンドポイント /api/mcp

実装予定

  • Convex関数のフル実装
  • 実際のデータベース統合
  • Todoist API同期機能
  • リアルタイム同期
  • 認証システム
  • ユーザー管理

セットアップ

1. 依存関係のインストール

npm install

2. 環境変数の設定

# .env.localファイルを作成（.env.exampleを参考に） cp .env.example .env.local # 必要な環境変数を設定 CONVEX_DEPLOYMENT=your-deployment-name NEXT_PUBLIC_CONVEX_URL=https://your-convex-url.convex.cloud TODOIST_API_TOKEN=your-todoist-api-token

3. Convexのセットアップ

# Convexの初期化 npx convex dev

4. 開発サーバーの起動

npm run dev

5. MCP Server のテスト

ブラウザで以下にアクセス：

  • http://localhost:3000 - メインダッシュボード
  • http://localhost:3000/test - MCPサーバーテスター

MCPテスターで以下の機能をテストできます：

  • サーバー初期化
  • ツール一覧取得
  • タスク・プロジェクト操作

API エンドポイント

MCP Server

  • POST /api/mcp - MCPプロトコルのメインエンドポイント
利用可能なツール
  • create_task - タスク作成
  • get_tasks - タスク一覧取得
  • update_task - タスク更新
  • create_project - プロジェクト作成
  • get_projects - プロジェクト一覧取得
リクエスト例
{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "create_task", "arguments": { "content": "新しいタスク", "priority": 2 } } }

ディレクトリ構造

mcp-todoist/ ├── convex/ # Convexバックエンド │ ├── schema.ts # データスキーマ │ ├── tasks.ts # タスク関連関数 │ └── projects.ts # プロジェクト関連関数 ├── src/ │ ├── app/ # Next.js App Router │ │ ├── api/mcp/ # MCP APIエンドポイント │ │ ├── layout.tsx # ルートレイアウト │ │ └── page.tsx # メインページ │ ├── lib/ │ │ ├── mcp/ # MCP Server実装 │ │ └── todoist/ # Todoist APIクライアント │ └── types/ # TypeScript型定義 ├── package.json ├── convex.json └── next.config.js

開発中の注意事項

  • 型エラーについて：Convexの生成ファイルが作成される前は一部型エラーが表示されますが、npx convex dev実行後に解決されます
  • Todoist APIキーが必要な機能についてはAPIキーを設定してください

次の開発段階

  1. Convex関数の実装完了
  2. MCPツールとConvex関数の統合
  3. Todoist API同期機能
  4. リアルタイム更新機能
  5. UIコンポーネントの拡充

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

A Model Context Protocol server implementation compatible with Todoist API, allowing AI agents to interact with task management functionality through standardized MCP tools.

  1. 技術スタック
    1. アーキテクチャ
      1. 主要機能
        1. 実装済み
        2. 実装予定
      2. セットアップ
        1. 依存関係のインストール
        2. 環境変数の設定
        3. Convexのセットアップ
        4. 開発サーバーの起動
        5. MCP Server のテスト
      3. API エンドポイント
        1. MCP Server
      4. ディレクトリ構造
        1. 開発中の注意事項
          1. 次の開発段階

            Related MCP Servers

            • Todo List MCP Server

              RegiByte
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.
              Last updated -
              10
              4
              TypeScript
              MIT License

            • Todoist MCP

              Doist
              A
              security
              A
              license
              A
              quality
              An MCP server that enables LLMs to interact with Todoist tasks, projects, and other features through the Todoist API.
              Last updated -
              36
              121
              66
              TypeScript
              MIT License
              • Apple
              • Linux

            • Tiny TODO MCP

              tkc
              -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
              Last updated -
              1
              TypeScript

            • TaskMaster

              mingolladaniele
              -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables Cursor AI assistants to interact with Todoist tasks directly from the coding environment, supporting advanced task filtering and rich formatting.
              Last updated -
              29
              Python
              • Linux
              • Apple

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/kentaroh7777/mcp-todoist'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server