Omnifocus MCP

🚀 OmniFocus MCP Server

OmniFocusをClaude Desktopと統合するためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーはClaudeにOmniFocusのタスクとプロジェクトへのアクセスを提供し、AIによるタスク管理と週次レビューを可能にします。

✨ 主な機能

• 🎯 OmniFocus統合 - OmniFocusからタスクとプロジェクトにアクセスできます。
• 🔧 アクティブなタスクのフィルタリング - 未完了のタスクのみを取得し、テンプレートやシステムアイテムを除外します。
• 🚀 TypeScript + MCP SDK - 型安全で保守性が高いです。
• 🔒 安全な自動化 - 公式のOmni Automation JavaScript APIを使用します。
• 📱 Claude Desktop対応 - Claude Desktopとシームレスに動作します。

🛠️ 現在のツール

omnifocus:get_all_tasks

OmniFocusからすべてのタスクを取得し、フィルタリングオプションがあります。

• includeCompleted (boolean) - 完了したタスクを含めるかどうか（デフォルト: false）
• limit (number) - 返すタスクの最大数（デフォルト: 100）

omnifocus:get_active_tasks

アクティブ（未完了）のタスクのみを取得し、自動的に以下を除外します。

• "Templates"フォルダ内のタスク
• テンプレートプレースホルダー（«, »）を含むタスク
• 同期設定マーカー（⚙️）があるタスク

omnifocus:get_projects

OmniFocusからすべてのアクティブなプロジェクトを取得します。

📋 前提条件

• OmniFocusがインストールされた macOS
• Node.js 23.10.0 以上
• Claude Desktop アプリケーション
• OmniFocusの 自動化権限

📦 インストール

1. リポジトリをクローンします。

   git clone https://github.com/mdoel/omnifocus-mcp
   cd omnifocus-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. Claude Desktopを設定します。

   Claude DesktopのMCP設定に以下を追加します。

   {
     "mcpServers": {
       "omnifocus": {
         "command": "/path/to/omnifocus/run-server.sh",
         "args": []
       }
     }
   }
   

   ⚠️ 重要提示

   /path/to/omnifocus/ を実際のプロジェクトディレクトリのパスに置き換えてください。

5. 自動化権限を付与します。

   サーバーを初めて実行すると、macOSがOmniFocusの自動化権限を付与するように促します。表示されたら「許可」をクリックしてください。

   💡 使用建议

   権限の問題が発生した場合は、run-server.sh の osascript 行のコメントを一時的に解除して権限ダイアログを表示させる必要がある場合があります。権限を付与した後は、起動時にダイアログが表示されないように、それらの行を再度コメントアウトしてください。

6. Claude Desktopを再起動 して、新しいMCPサーバーを読み込みます。

💻 使用例

設定が完了したら、Claudeに以下のように要求できます。

• "OmniFocusからすべてのアクティブなタスクを取得して"
• "私のプロジェクトを表示して"
• "今日のタスクは何がありますか？"
• "週次レビューを手伝って"

🔧 技術詳細

コアコンポーネント

• OmniFocusClient - Omni Automationを介してOmniFocusとの通信を処理します。
• OmniFocusJXA - JXAスクリプトの構築と実行のユーティリティです。
• OmniFocusMCPServer - 主なMCPサーバーの実装です。

ディレクトリ構造

src/
├── index.ts              # メインエントリポイント
├── server.ts             # MCPサーバーの実装
├── omnifocus/
│   ├── client.ts         # OmniFocus自動化クライアント
│   └── omnifocus-jxa.ts  # JXAスクリプトユーティリティ
└── types/
    └── omnifocus.ts      # TypeScript定義

🛠️ 開発

ビルド

# プロジェクトをビルドします。
npm run build

# 開発用のウォッチモード
npm run dev

テスト

サーバーをローカルでテストできます。

# コマンドライン引数でテストします。
node dist/index.js all        # すべてのタスクを取得
node dist/index.js active     # アクティブなタスクのみを取得
node dist/index.js projects   # プロジェクトのみを取得

OmniFocus自動化のテスト

OmniFocusの自動化を直接テストします。

# 基本的な接続をテストします。
osascript -l JavaScript -e "Application('OmniFocus').running()"

# タスクの取得をテストします。
osascript -l JavaScript -e "
const app = Application('OmniFocus');
const doc = app.defaultDocument;
const tasks = doc.flattenedTasks();
console.log('Found ' + tasks.length + ' tasks');
"

⚠️ トラブルシューティング

サーバー接続の問題

Claude Desktopがサーバーに接続できない場合：

1. Claude Desktopの設定で スクリプトのパスを確認 してください。
2. 権限を確認 して、run-server.sh スクリプトが実行可能であることを確認します。

   chmod +x run-server.sh
   

3. Node.jsのインストールを確認 して、Node.js 23.10.0以上がインストールされていることを確認します。
4. ログを確認 して、Claude DesktopのMCPサーバーログにエラーメッセージがないか確認してください。

権限の問題

自動化権限のエラーが発生した場合：

1. システム環境設定 > セキュリティとプライバシー > プライバシー を開きます。
2. 左側のサイドバーから 自動化 を選択します。
3. ターミナル/シェルを見つけて、OmniFocus をチェックします。
4. ターミナルを再起動して、再度試してみてください。

OmniFocusが見つからない場合

• OmniFocusがインストールされて実行されていることを確認してください。
• アプリ名が "OmniFocus"（"OmniFocus 3" などではない）であることを確認してください。
• OmniFocusがゴミ箱に入っていたり、無効になっていないことを確認してください。

パフォーマンスの問題

サーバーが遅いかタイムアウトする場合：

• サーバーが大きなOmniFocusデータベースを処理するのに時間がかかる場合があります。
• limit パラメーターを使用して、返されるタスクの数を減らすことを検討してください。
• OmniFocusが他の操作を実行していないことを確認してください。

🤝 コントリビュート

このプロジェクトは拡張可能に設計されています。新しい機能を追加するには：

1. src/omnifocus/ ディレクトリに 新しいツールを追加 します。
2. 新しいツールを登録するように サーバーを更新 します。
3. 自分のOmniFocusデータで 十分にテスト します。
4. 明確なドキュメントとともに プルリクエストを送信 します。

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

🆘 サポート

問題や質問がある場合は：

• 上記のトラブルシューティングセクションを確認してください。
• Claude DesktopのMCPドキュメントを確認してください。
• このリポジトリに問題を登録してください。