免責事項:文書の剛さをパルドンし、言語をコミットします。このプロジェクトは、Claudeコードを介して完全にコードされ、Ao多くのメッセージは、会計報告書(ここで車のセールスマンのランダムな重点と)として楽しいものです。

高度なタスク管理機能を提供するOmniFocusのプロフェッショナルなモデルコンテキストプロトコル(MCP)サーバーは、スマートキャッシュと分析を提供します。 OmniFocusの公式OmniAutomation APIのTypeScriptと完全敬意を表しています。

##特徴

コア機能

• スマートなキャッシュ:最適性能のためのTTLベースのキャッシュ システム
• タイプ安全:包括的なタイプとの完全なTypeScriptサポート -公式 APIのみ:OmniAutomationスクリプトのみを使用する(データベースのハッキングなし) -高性能:インテリジェントキャッシングで1000以上のタスクを効率的に処理します

利用可能なツール

タスク操作 (読み込み)

• [list_tasks - スマートキャッシュでフィルタリングする高度なタスク
• フィルタ:補完ステータス、フラグ、プロジェクト、タグ、日付、検索条件
• 受信トレイのフィルタリングと可用性チェックをサポート
• 適切なペジネーションメタデータで最大1000タスクをサポート
• 落雷速繰り返されたクエリの30秒間キャッシュされた結果

Model Context Protocol for OmniFocus (incl. advanced features)

Disclaimer: pardon the stiffness of the documentation and commits language, the project is fully coded via Claude Code, ao many messages are either as fun as an accounting report (with random emphasis of a car salesman here and there).

A professional Model Context Protocol (MCP) server for OmniFocus that provides advanced task management capabilities with smart caching and analytics. Built with TypeScript and full respect for OmniFocus’s official OmniAutomation API.

Features

Core Capabilities

• Smart Caching: TTL-based caching system for optimal performance
• Type Safety: Full TypeScript support with comprehensive types
• Official API Only: Uses only OmniAutomation scripts (no database hacking)
• High Performance: Handles 1000+ tasks efficiently with intelligent caching

Available Tools

Task Operations (Read)

• list_tasks - Advanced task filtering with smart caching
  • Filter by: completion status, flags, project, tags, dates, search terms
  • Supports inbox filtering and availability checks
  • Supports up to 1000 tasks with proper pagination metadata
  • Results cached for 30 seconds for lightning-fast repeated queries
• get_task_count - Get count of tasks matching filters without data
  • Same filtering options as list_tasks
  • Returns count only for performance

Task Operations (Write)

• create_task - Create new tasks in inbox
  • Set name, note, flagged status, due/defer dates
  • Tag assignment limited to existing tags
  • Returns temporary ID (JXA limitation)
• update_task - Update existing tasks
  • Modify name, note, flagged status, dates
  • Limited tag management due to JXA
• complete_task - Mark tasks as completed
• delete_task - Remove tasks

Project Operations

• list_projects - List and filter projects with caching
  • Filter by: status (active, on hold, dropped, completed), flags, folder
  • Results cached for 5 minutes
• create_project - Create new projects with folder support
  • Automatically creates folders if they don’t exist
  • Set name, note, dates, flags, and parent folder
• update_project - Update project properties
  • Change name, note, status, dates, flags
  • Folder movement supported with limitations (JXA constraint)
• complete_project - Mark projects as done
• delete_project - Remove projects from OmniFocus

Coming Soon

• Analytics tools (productivity stats, velocity tracking, overdue analysis)
• Tag management
• Bulk operations
• Smart search with natural language
• Recurring task analysis

Installation & Permissions

Prerequisites

1. OmniFocus 3 or later installed on macOS
2. Node.js 18+ installed
3. Permission to access OmniFocus via automation (see Permissions Guide)

Installation Steps

# Clone the repository
git clone https://github.com/yourusername/omnifocus-cache-by-windsurf.git
cd omnifocus-cache-by-windsurf