Omnifocus MCP

🚀 OmniFocus MCP サーバー

OmniFocus と統合されたモデルコンテキストプロトコル (MCP) サーバーです。Claude（またはその他の MCP 互換の AI アシスタント）が自然言語対話を通じて、OmniFocus のタスクやプロジェクトとやり取りできるようにします。

🚀 クイックスタート

前提条件

• OmniFocus がインストールされた macOS システム

Claude への接続

1. Claude Desktop で、この MCP サーバーを設定ファイルに追加します。

~/Library/Application Support/Claude/claude_desktop_config.json

2. 以下の設定を追加します。

{
  "mcpServers": {
    "omnifocus": {
      "command": "npx",
      "args": ["-y", "omnifocus-mcp"]
    }
  }
}

3. Claude を起動し、新しい OmniFocus MCP サーバーに接続します。

✨ 主な機能

この MCP サーバーは、AI アシスタント（Claude など）と OmniFocus タスク管理システムの間に架ける橋渡しの役割を果たします。AI モデルが OmniFocus データベース内のタスクやプロジェクトを閲覧、作成、編集、削除できるようにします。

いくつかの使用方法を紹介します。

• コース大綱の PDF を、具体的なタスク、タグ、延期日、期限を含む完全なプロジェクトに変換する。
• 会議記録をアクションリストに変換する。
• OmniFocus 内でタスク、プロジェクト、タグの可視化を作成する。
• 複数のタスクやプロジェクトを一度に処理する。
• OmniFocus プロジェクトを効率的に一括管理する。

📦 インストール

基本的なツール

# npm パッケージをインストールする（必要な場合）
npm install -g @omnifocus/mcp-server

サーバーの起動

omni-mcp-server

💻 使用例

基本的な使用法

{
  "command": "add_task",
  "params": {
    "name": "完成项目报告",
    "dueDate": "2024-03-25T17:00:00Z",
    "projectName": "工作"
  }
}

高度な使用法

{
  "command": "get_projects"
}

ツール一覧

• add_task: 指定したプロジェクトに新しいタスクを追加します。
• add_project: 新しいプロジェクトを作成し、OmniFocus データベースに追加します。
• delete_task: ID を指定して特定のタスクを削除します。
• complete_task: タスクを完了し、完了済みとしてマークします。
• update_task: 既存のタスクの属性を更新します。
• search: データベース内のタスクやプロジェクトを検索します。
• export_data: OmniFocus のデータを JSON ファイルにエクスポートします。

開発ガイド

依存関係のインストール

npm install @omnifocus/mcp-server

開発サーバーの起動

npx mcp-server start

デバッグモード

DEBUG=omni-mcp-server npm start

詳細情報

• 公式ドキュメント: 詳細な開発ドキュメントや API リファレンスを参照します。
• 問題フィードバック: エラーや機能リクエストを送信します。

🔧 技術詳細

このサーバーは AppleScript を使用して OmniFocus と通信し、アプリケーションのネイティブ機能にアクセスできるようにします。また、モデルコンテキストプロトコル (MCP) SDK を使用して構築されており、AI モデルが外部ツールやシステムとやり取りするための標準化された方法を提供します。

📄 ライセンス

MIT