免责声明:赦免文件的僵硬性,承诺语言,项目完全通过克洛德代码(Claude Code)编码,许多信息要么像会计报告一样有趣(随意强调这里和那里汽车销售员).

OmniFocus专业的模型背景协议(MCP)服务器,提供高级任务管理能力,具有智能缓存和分析功能. 由TypeScript所建并充分尊重OmniFocus官方OmniAutomation API.

□ 特性

• 核心能力

• ** Smart Caching**:基于TTL的缓存系统,用于最佳性能
• ** 类型安全**:全类型脚本支持,包括全面类型
• ** 官方API 只**:只使用 OmniAutomation 脚本(没有数据库黑客)
• ** 高性能**:用智能缓存高效地处理1000多项任务

可用的工具

任务操作(读)

• list_tasks - 用智能缓存进行高级任务过滤
• 筛选:完成状态、旗帜、项目、标记、日期、搜索条件
• 支持收件箱过滤和可用性检查
• 支持多达1 000项任务,并配有适当的标记元数据
• 闪电快跑重复查询的结果缓存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