Omnifocus MCP CLI

OmniFocus CLI

OmniFocus命令行界面(of)

（非官方） macOS上OmniFocus 4的命令行桥。

of 是一个快速、可编写脚本的命令行界面，可将您的OmniFocus任务、项目和GTD工作流带到终端。

______________________________________________________________________

💡 问题

OmniFocus是苹果平台上GTD的黄金标准，但编写脚本总是很痛苦：

1. AppleScript开销： 每个命令都会产生一个新的脚本过程，使批处理操作变慢。
2. 无CLI本机： 居住在终端中的高级用户必须上下文切换到GUI进行任务管理。
3. 管道不友好： OmniFocus不能很好地与Unix工具集成(grep, xargs, jq等等）。

🚀 解决方案

of 使用现代Node.js CLI封装优化的JXA（JavaScript for Automation）脚本，为您提供：

• 快速查询： 以毫秒为单位列出收件箱、今天、标记、项目等
• Unix友好输出： JSON和安静脚本模式
• 批量操作： 要添加、完成或修改的管道任务列表
• 干运行安全： 提交前预览更改

______________________________________________________________________

🛠 安装

# Clone or download this repository
cd omnifocus-cli

# Install dependencies
bun install

# Link globally (makes 'of' available everywhere)
bun link

要求：

• macOS（已安装OmniFocus 4）
• Node.js 18+或Bun

______________________________________________________________________

⚡ 快速开始

# List your inbox
of list inbox

# Today's tasks
of list today

# Add a quick task
of add "Buy milk"

# Add task with options
of add "Review proposal" --project "Work" --due tomorrow --flagged

# Complete a task
of complete 

# Search for tasks
of search "meeting"

# Trigger sync
of sync

______________________________________________________________________

📖 命令

列表

常见标志： --json, --pretty, --quiet （仅限ID）， --limit N, --all （包括已完成）

添加

# Single task
of add "Task name" --project "Project" --due tomorrow --tag "Context"

# Quick add (inbox only)
of quick "Fast task" --flagged

# New project with tasks
of add project "New Website" --folder "Work" --tasks "Design,Build,Deploy"

# Bulk from stdin
cat tasks.txt | of add --project "Inbox Processing"

# Batch projects from outline
cat outline.md | of add batch --folder "Q1 Goals"

修改

# Update task
of modify  --due "+3d" --flagged

# Move task to project
of modify  --project "Different Project"

# Reorder tasks within a project
of modify  --order 0  # Move to first position

# Update project
of project modify  --status on-hold

完成

# Complete task
of complete 

# Drop task (mark abandoned)
of complete  --drop

# Delete task permanently
of complete  --delete

# Bulk complete from stdin
of list inbox -q | xargs -I {} of complete {}

组织

# Create folder
of folder add "New Folder"

# Create tag
of tag add "New Tag"

# Move project to folder
of project move 
 --folder "Work"

# Review projects needing review
of review

公用事业

# Trigger OmniFocus sync
of sync

# Get task details
of get task 

# Search tasks
of search "keyword" --limit 20

# Generate shell completions
of completion bash >> ~/.bashrc
of completion zsh >> ~/.zshrc

MCP服务器

# Start MCP server (stdio transport)
of mcp run

# Show MCP configuration info
of mcp info

______________________________________________________________________

🔧 输出模式

所有命令都支持多种输出格式：

# Human-readable (default)
of list inbox

# JSON for scripting
of list inbox --json

# Pretty JSON
of list inbox --json --pretty

# IDs only (for piping)
of list inbox -q

______________________________________________________________________

🏗 建筑

omnifocus-cli/
├── bin/of.js           # CLI entry point
├── src/
│   ├── index.js        # Command registration
│   ├── jxa-runner.js   # JXA execution bridge
│   ├── output.js       # Output formatting
│   ├── commands/       # Command handlers
│   └── mcp/
│       └── server.js   # MCP server implementation
└── jxa/
    ├── read/           # Query scripts
    ├── write/          # Mutation scripts
    └── utils/          # Shared helpers

CLI生成 osascript -l JavaScript 执行通过macOS脚本桥与OmniFocus通信的JXA脚本。MCP服务器封装了这些相同的JXA脚本，将它们作为AI助手的工具公开。

______________________________________________________________________

💻 例子

每日回顾脚本

#!/bin/bash
echo "=== Today's Focus ==="
of list today --limit 5

echo -e "\n=== Flagged Items ==="
of list flagged --limit 5

echo -e "\n=== Inbox Count ==="
of list inbox -q | wc -l | xargs echo "Items in inbox:"

将收件箱处理为项目

# Move all inbox items to a project
of list inbox -q | while read id; do
  of modify "$id" --project "Processing"
done

从文件批量添加

# tasks.txt (one per line)
# Review Q4 report
# Schedule team meeting
# Update documentation

cat tasks.txt | of add --project "Work" --due "+1w"

创建项目结构

# outline.md
# - Website Redesign
#   - Research competitors
#   - Create wireframes
#   - Build prototype
# - Marketing Campaign
#   - Draft copy
#   - Design assets

cat outline.md | of add batch --folder "2026 Projects"

______________________________________________________________________

🤖 MCP服务器

of 包括内置 模型上下文协议 服务器，使AI助手（Claude等）能够直接管理OmniFocus。

设置

添加到您的Claude代码配置中(~/.claude/settings.json):

{
  "mcpServers": {
    "omnifocus": {
      "command": "of",
      "args": ["mcp", "run"]
    }
  }
}

或者使用完整路径：

{
  "mcpServers": {
    "omnifocus": {
      "command": "node",
      "args": ["/path/to/omnifocus-cli/bin/of.js", "mcp", "run"]
    }
  }
}

可用工具（5个合并工具）

每个工具都使用 action 参数来选择操作。这种整合的设计最大限度地减少了令牌开销，同时提供了完整的OmniFocus访问权限。

示例提示

配置后，您可以向Claude询问以下问题：

• “我的OmniFocus收件箱里有什么？”
• “创建一个任务，明天给妈妈打电话”
• “显示所有标记的任务”
• 添加一个名为“网站重新设计”的项目，其中包含设计、开发和测试任务
• “将任务ABC123标记为已完成”

______________________________________________________________________

🗺 路线图

• \[x\] 第一阶段： 具有完整读/写OmniFocus访问权限的CLI工具
• \[x\] 第二阶段： 用于AI助手集成的MCP服务器

______________________________________________________________________

📄 许可证

麻省理工学院

作者：沈（@2b3pro） — 给我买一两杯咖啡 ☕