AIクライアントからkakikoのタスクを操作する（MCP連携）

Claude DesktopやClaude CodeなどのAIクライアントからkakikoのタスクやルーティンを操作するためのMCPサーバーの設定方法を説明します。

この記事では、MCPサーバーを設定し、AIクライアントからkakikoのタスク・ルーティンを操作する方法を説明します。

MCPサーバーとは

MCP（Model Context Protocol）サーバーは、AIクライアント（Claude Desktop、Claude Code、Cursorなど）からkakikoのデータに直接アクセスするための仕組みです。

MCPサーバーを設定すると、AIとの会話の中で以下の操作が可能になります。

  • タスクの検索・作成・更新・削除
  • ルーティン（習慣）の一覧取得
  • ダッシュボード情報（今日の期限タスク数、期限切れ数など）の取得

前提条件

  • Node.js 18.0.0 以上がインストールされていること
  • kakikoデスクトップアプリがインストール済みで、一度以上起動していること

セットアップ手順

Claude Desktop

  1. Claude Desktopの設定ファイルを開きます。
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. 以下の内容を追加します。
{
  "mcpServers": {
    "kakiko": {
      "command": "npx",
      "args": ["-y", "@frater/kakiko-mcp-server"]
    }
  }
}
  1. Claude Desktopを再起動します。

Windows環境では cmd 経由で実行します。

{
  "mcpServers": {
    "kakiko": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@frater/kakiko-mcp-server"]
    }
  }
}

Claude Code

  1. プロジェクトの .mcp.json に以下を追加します。
{
  "mcpServers": {
    "kakiko": {
      "command": "npx",
      "args": ["-y", "@frater/kakiko-mcp-server"]
    }
  }
}

Cursor

  1. Cursor Settings を開きます。
  2. 「MCP Servers」セクションに以下を追加します。
{
  "kakiko": {
    "command": "npx",
    "args": ["-y", "@frater/kakiko-mcp-server"]
  }
}

データベースパスの指定

MCPサーバーはkakikoのSQLiteデータベースのパスを自動検出します。通常は設定不要です。

自動検出されるデフォルトパスは以下のとおりです。

OSパス
macOS~/Library/Application Support/io.kakiko/kakiko.db
Windows%APPDATA%\io.kakiko\kakiko.db
Linux~/.local/share/io.kakiko/kakiko.db

データベースの保存場所を変更している場合は、--db オプションで明示的に指定します。

{
  "mcpServers": {
    "kakiko": {
      "command": "npx",
      "args": ["-y", "@frater/kakiko-mcp-server", "--db", "/path/to/kakiko.db"]
    }
  }
}

読み取り専用モード

タスクの作成・更新・削除を無効にし、読み取り操作のみ許可するには --readonly オプションを追加します。

{
  "mcpServers": {
    "kakiko": {
      "command": "npx",
      "args": ["-y", "@frater/kakiko-mcp-server", "--readonly"]
    }
  }
}

読み取り専用モードでは、tasks_mutate ツールが無効になります。

AIクライアントからの操作例

タスクの検索

AIに「今日期限のタスクを教えて」と伝えると、tasks_query ツールでタスクを検索します。ステータス、タグ、期限、テキストで絞り込みが可能です。

タスクの作成

AIに「明日までに資料を作成するタスクを追加して」と伝えると、tasks_mutate ツールでタスクを作成します。タイトル、説明、タグ、期限を指定できます。

ダッシュボード情報の確認

AIに「今日のタスク状況を教えて」と伝えると、kakiko_overview ツールで以下の情報を取得します。

  • 今日の期限タスク数、期限切れタスク数
  • 進行中のタスク数、今日完了したタスク数
  • 今週の完了数と作成数
  • アクティブなルーティン数

ルーティンの確認

AIに「ルーティンの一覧を見せて」と伝えると、routines_query ツールでルーティン情報を取得します。

リアルタイム同期

MCPサーバー経由でタスクを変更すると、kakikoアプリの画面に自動的に反映されます。kakikoアプリが変更を2秒間隔で検知し、タスクリストを自動更新します。

提供ツール一覧

ツール名操作説明
tasks_query読み取りタスクの検索・フィルタリング
tasks_get読み取り単一タスクの詳細取得
tasks_mutate書き込みタスクの作成・更新・削除・ステータス変更・スリープ操作
routines_query読み取りルーティン一覧の取得
kakiko_overview読み取りダッシュボード統計情報の取得