Omnifocus MCP Enhanced

🚀 OmniFocus MCP Enhanced

🌟 新機能: 階層表示付きのネイティブなカスタムパースペクティブアクセス！

カスタムパースペクティブサポートにより、OmniFocusをAI搭載の生産性向上ツールに変えましょう

OmniFocus用の強化されたモデルコンテキストプロトコル（MCP）サーバーです。ネイティブなカスタムパースペクティブアクセス、階層的なタスク表示、AI最適化されたツール選択、そして包括的なタスク管理機能を備えています。Claude AIとの完全な統合により、インテリジェントなワークフローが実現可能です。

✨ 主な機能

🌟 新機能: ネイティブなカスタムパースペクティブアクセス

• 🎯 直接統合 - Perspective.Custom APIを介して、OmniFocusのカスタムパースペクティブにネイティブアクセスできます。
• 🌳 階層表示 - 親子関係を持つタスクをツリー形式で視覚化します。
• 🧠 AI最適化 - 強化されたツール説明により、AIがパースペクティブとタグを混同することがなくなります。
• ⚡ ゼロセットアップ - 既存のカスタムパースペクティブですぐに使用できます。

🏗️ 完全なタスク管理

• 🏗️ 完全なサブタスクサポート - 親子関係を持つ階層的なタスクを作成できます。
• 🔍 組み込みパースペクティブ - インボックス、フラグ付き、予測、タグベースのビューにアクセスできます。
• 🚀 究極のタスクフィルター - OmniFocusの標準機能を超える高度なフィルタリングが可能です。
• 🎯 バッチ操作 - 複数のタスクを効率的に追加/削除できます。
• 📊 スマートクエリ - ID、名前、または複雑な条件でタスクを検索できます。
• 🔄 完全なCRUD操作 - タスクとプロジェクトの作成、読み取り、更新、削除が可能です。
• 📅 時間管理 - 期限日、延期日、見積もり時間、スケジューリングがサポートされています。
• 🏷️ 高度なタグ付け - 完全一致/部分一致によるタグベースのフィルタリングができます。
• 🤖 AI統合 - インテリジェントなワークフローのために、Claude AIとシームレスに統合されています。

📦 インストール

クイックインストール（推奨）

# ワンラインインストール
claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced

代替インストール方法

# グローバルインストール
npm install -g omnifocus-mcp-enhanced
claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced

# ローカルプロジェクトインストール
git clone https://github.com/jqlts1/omnifocus-mcp-enhanced.git
cd omnifocus-mcp-enhanced
npm install && npm run build
claude mcp add omnifocus-enhanced -- node "/path/to/omnifocus-mcp-enhanced/dist/server.js"

📋 必要条件

• macOS 10.15以上 - OmniFocusはmacOS専用です。
• OmniFocus 3以上 - アプリケーションをインストールし、実行しておく必要があります。
• OmniFocus Pro - カスタムパースペクティブには必要です（v1.6.0の新機能）。
• Node.js 18以上 - MCPサーバーを実行するために必要です。
• Claude Code - MCP統合に必要です。

🎯 核心機能

1. 🏗️ サブタスク管理

簡単に複雑なタスク階層を作成できます。

// 親タスク名でサブタスクを作成
{
  "name": "Analyze competitor keywords",
  "parentTaskName": "SEO Strategy",
  "note": "Focus on top 10 competitors",
  "dueDate": "2025-01-15",
  "estimatedMinutes": 120,
  "tags": ["SEO", "Research"]
}

// 親タスクIDでサブタスクを作成
{
  "name": "Write content outline",
  "parentTaskId": "loK2xEAY4H1",
  "flagged": true,
  "estimatedMinutes": 60
}

2. 🔍 パースペクティブビュー

すべての主要なOmniFocusパースペクティブにプログラムでアクセスできます。

# インボックスパースペクティブ
get_inbox_tasks {"hideCompleted": true}

# フラグ付きタスク
get_flagged_tasks {"projectFilter": "SEO Project"}

# 予測（次の7日間）
get_forecast_tasks {"days": 7, "hideCompleted": true}

# タグでタスクを取得
get_tasks_by_tag {"tagName": "AI", "exactMatch": false}

3. 🚀 究極のタスクフィルター

高度なフィルタリングにより、想像できるあらゆるパースペクティブを作成できます。

# 時間管理ビュー（今週期限の30分以内のタスク）
filter_tasks {
  "taskStatus": ["Available", "Next"],
  "estimateMax": 30,
  "dueThisWeek": true
}

# 集中作業ビュー（60分以上のメモ付きタスク）
filter_tasks {
  "estimateMin": 60,
  "hasNote": true,
  "taskStatus": ["Available"]
}

# プロジェクトの期限切れタスク
filter_tasks {
  "projectFilter": "Website Redesign",
  "taskStatus": ["Overdue", "DueSoon"]
}

4. 🌟 新機能: ネイティブなカスタムパースペクティブアクセス

階層的なタスク表示でOmniFocusのカスタムパースペクティブにアクセスできます。

# 🌟 新機能: すべてのカスタムパースペクティブをリスト表示
list_custom_perspectives {"format": "detailed"}

# 🌳 新機能: ツリー表示でカスタムパースペクティブからタスクを取得
get_custom_perspective_tasks {
  "perspectiveName": "今日工作安排",  # あなたのカスタムパースペクティブ名
  "showHierarchy": true,            # ツリー表示を有効にする
  "hideCompleted": true
}

# 異なるパースペクティブの例
get_custom_perspective_tasks {
  "perspectiveName": "Today Review",
  "showHierarchy": true
}

get_custom_perspective_tasks {
  "perspectiveName": "Weekly Planning",
  "showHierarchy": false  # フラット表示
}

この機能が強力な理由:

• ✅ ネイティブ統合 - OmniFocusのPerspective.Custom APIを直接使用します。
• ✅ ツリー構造 - ├─、└─ 記号で親子関係のタスクを視覚化します。
• ✅ AIフレンドリー - 強化された説明により、ツール選択の混乱が防止されます。
• ✅ プロフェッショナルな出力 - きれいで読みやすいタスク階層が表示されます。

5. 🎯 バッチ操作

複数のタスクを効率的に管理できます。

{
  "items": [
    {
      "type": "task",
      "name": "Website Technical SEO",
      "projectName": "SEO Project",
      "note": "Optimize technical aspects"
    },
    {
      "type": "task",
      "name": "Page Speed Optimization",
      "parentTaskName": "Website Technical SEO",
      "estimatedMinutes": 180,
      "flagged": true
    },
    {
      "type": "task",
      "name": "Mobile Responsiveness",
      "parentTaskName": "Website Technical SEO",
      "estimatedMinutes": 90
    }
  ]
}

🛠️ 完全なツールリファレンス

📊 データベースとタスク管理

1. dump_database - OmniFocusのデータベース状態を取得します。
2. add_omnifocus_task - タスクを作成します（サブタスクサポート強化版）。
3. add_project - プロジェクトを作成します。
4. remove_item - タスクまたはプロジェクトを削除します。
5. edit_item - タスクまたはプロジェクトを編集します。
6. batch_add_items - 一括追加（サブタスクサポート強化版）。
7. batch_remove_items - 一括削除。
8. get_task_by_id - タスク情報をクエリします。

🔍 組み込みパースペクティブツール

9. get_inbox_tasks - インボックスパースペクティブ。
10. get_flagged_tasks - フラグ付きパースペクティブ。
11. get_forecast_tasks - 予測パースペクティブ（期限/延期タスク）。
12. get_tasks_by_tag - タグベースのフィルタリング。
13. filter_tasks - 無制限の組み合わせでの究極のフィルタリング。

🌟 カスタムパースペクティブツール（新機能）

14. list_custom_perspectives - 🌟 新機能: すべてのカスタムパースペクティブを詳細表示します。
15. get_custom_perspective_tasks - 🌟 新機能: 階層表示でカスタムパースペクティブにアクセスします。

📊 分析と追跡

16. get_today_completed_tasks - 今日完了したタスクを表示します。

🚀 クイックスタート例

基本的なタスク作成

# シンプルなタスク
add_omnifocus_task {
  "name": "Review quarterly goals",
  "projectName": "Planning",
  "dueDate": "2025-01-31"
}

高度なタスク管理

# 親タスクを作成
add_omnifocus_task {
  "name": "Launch Product Campaign",
  "projectName": "Marketing",
  "dueDate": "2025-02-15",
  "tags": ["Campaign", "Priority"]
}

# サブタスクを追加
add_omnifocus_task {
  "name": "Design landing page",
  "parentTaskName": "Launch Product Campaign",
  "estimatedMinutes": 240,
  "flagged": true
}

スマートなタスク検索

# 高優先度の作業を検索
filter_tasks {
  "flagged": true,
  "taskStatus": ["Available"],
  "estimateMax": 120,
  "hasEstimate": true
}

# 今日完了した作業
filter_tasks {
  "completedToday": true,
  "taskStatus": ["Completed"],
  "sortBy": "project"
}

🌟 カスタムパースペクティブの使用

# カスタムパースペクティブをリスト表示
list_custom_perspectives {"format": "detailed"}

# 階層付きでカスタムパースペクティブにアクセス
get_custom_perspective_tasks {
  "perspectiveName": "Today Review",
  "showHierarchy": true,
  "hideCompleted": true
}

# 週間計画のクイックフラットビュー
get_custom_perspective_tasks {
  "perspectiveName": "Weekly Planning",
  "showHierarchy": false
}

🔧 設定

インストールを確認

# MCPの状態を確認
claude mcp list

# 基本的な接続をテスト
get_inbox_tasks

# 新しいカスタムパースペクティブ機能をテスト
list_custom_perspectives

トラブルシューティング

• OmniFocus 3以上がインストールされ、実行されていることを確認してください。
• Node.js 18以上がインストールされていることを確認してください。
• Claude Code MCPの設定を確認してください。
• 必要に応じて、ターミナルアプリのアクセシビリティ権限を有効にしてください。

🎯 使用例

• プロジェクト管理 - サブタスクを持つ詳細なプロジェクト階層を作成します。
• GTDワークフロー - モノを終わらせるための方法論であるGTDにパースペクティブを活用します。
• タイムブロッキング - 予定時間でフィルタリングして、スケジュールを計画します。
• レビュープロセス - 週次/月次のレビューにカスタムパースペクティブを使用します。
• チームコーディネーション - チームのタスク割り当てにバッチ操作を使用します。
• AI搭載の計画 - Claudeにタスクを分析して整理させます。

📈 パフォーマンス

• 高速フィルタリング - ネイティブのAppleScriptパフォーマンス。
• バッチ効率 - 単一操作で複数のタスクを処理。
• メモリ最適化 - 最小限のリソース使用。
• スケーラブル - 大規模なタスクデータベースを効率的に処理。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合は、テストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

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

🔗 リンク

• NPMパッケージ: https://www.npmjs.com/package/omnifocus-mcp-enhanced
• GitHubリポジトリ: https://github.com/jqlts1/omnifocus-mcp-enhanced
• OmniFocus: https://www.omnigroup.com/omnifocus/
• モデルコンテキストプロトコル: https://modelcontextprotocol.io/
• Claude Code: https://docs.anthropic.com/en/docs/claude-code

🙏 謝辞

themotionmachineによる元のOmniFocus MCPサーバーをベースにしています。パースペクティブビュー、高度なフィルタリング、および完全なサブタスクサポートで強化されています。

⭐ このリポジトリがあなたの生産性向上に役立つ場合は、スターをつけてください！