OmniFocus Operator MCPサーバー
コミット 2026年11月13日OmniFocusのタスク、プロジェクト、タグをAIエージェントに公開し、構造化されたタスク管理と自動化を実現します。
別名 HelloThisIsFlo/omnifocus-operator
- スター
- 11
- ツール
- 11
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月13日
- ライセンス
- —
OmniFocus Operator MCPとは
OmniFocusのタスク、プロジェクト、タグをAIエージェントに公開し、構造化されたタスク管理と自動化を実現します。 11個のツールを提供しており、get_all, get_task, get_projectなどがあります。
プロジェクトのREADMEから生成された概要
OmniFocus Operator MCP server について
このサーバーは、macOSユーザーがAIエージェントを通じて、複雑なタスクリストやプロジェクトの階層を管理することを可能にします。OmniFocus 4をClaude Desktop、Claude Code、CursorなどのMCPクライアントに接続し、エージェントが個人の生産性データと直接やり取りできるようにします。uvxを使用してサーバーを実行することで、手動のインストールプロセスを経ることなく、既存のタスクインフラを迅速に統合できます。
このサーバーは、特定のタスク、プロジェクト、タグの検索や、日付、フラグ、利用可能性による大規模リストのフィルタリングを行うための11個の専用ツールを提供します。書き込み操作もサポートしており、エージェントはすべてのフィールドを制御して新しいタスクを作成したり、パッチセマンティクスを使用して既存のタスクのノートを更新したり、プロジェクト間の移動、繰り返しルールの管理を行ったりできます。
パフォーマンスを重視しており、SQLiteキャッシュを活用することで46msの読み取りを実現しています。これは、標準的なブリッジのみの実装よりも大幅に高速です。また、信頼性を重視して設計されており、OmniJSブリッジへの自動フォールバック機能や、使用中にサーバーが復旧可能な状態を維持するための段階的な機能低下(graceful degradation)を備えています。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
OmniFocus Operator MCPツール 11
READMEから検出get_allget_taskget_projectget_taglist_taskslist_projectslist_tagslist_folderslist_perspectivesadd_tasksedit_tasks
| get_all | — | |
| get_task | — | |
| get_project | — | |
| get_tag | — | |
| list_tasks | — | |
| list_projects | — | |
| list_tags | — | |
| list_folders | — | |
| list_perspectives | — | |
| add_tasks | — | |
| edit_tasks | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能hellothisisflo/omnifocus-operator is public and reachablegithub.com/hellothisisflo/omnifocus-operator ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-12github.com/hellothisisflo/omnifocus-operator ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない11 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る🎯 OmniFocus Operator
The last OmniFocus MCP Server you'll ever need.
Production-grade MCP server exposing OmniFocus as structured task infrastructure for AI agents. Agent-first design, SQLite-cached performance, 2,561 tests.
→ See the full landing page — features, architecture, benchmarks, and comparison
🚀 Quick Start
Prerequisites: macOS, OmniFocus 4, Python 3.12+
🪄 Not sure where this config goes? The setup wizard on the landing page walks you through it step-by-step — including auto-merging with your existing config.
For Claude Desktop
Paste this into ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"omnifocus-operator": {
"command": "uvx",
"args": ["omnifocus-operator"]
}
}
}
uvx downloads, isolates, and runs the server automatically. No install step.
First run: OmniFocus shows a one-time permission dialog. Tick the box, click Run Script. You won't see it again.
⚠️ Claude Desktop on recent macOS — temporary extra step. macOS may block the server from reading OmniFocus's data. From v1.4.6 the server stays up and every tool call tells you exactly what to do, including the path to add. In short:
- If macOS asks whether
uvxmay access data from other apps, click Allow (it asks again on each launch).- To stop being asked, or if no prompt appears: open System Settings → Privacy & Security → Full Disk Access, click +, press ⌘⇧G, and add the real
uvxbinary. The server's error message names its exact path.- Quit Claude Desktop completely (⌘Q) and reopen it.
Granting Full Disk Access to Claude itself does not help — Claude Desktop launches MCP servers as their own responsible process. The grant applies to everything you run through
uvx, not only OmniFocus Operator. Terminal clients such as Claude Code are not affected. A proper installer that removes this step is planned.
For Claude Code, OpenCode, Cursor…
Ask your agent — copy this prompt:
Add this MCP server to my client config. Just edit the config file — don't install anything, don't run any scripts.
"omnifocus-operator": { "command": "uvx", "args": ["omnifocus-operator"] }
⚠️ This doesn't work with Claude Desktop — Desktop has no config-editing tools. Use the manual paste above.
git clone https://github.com/HelloThisIsFlo/omnifocus-operator.git
cd omnifocus-operator
uv sync
See CONTRIBUTING.md for dev workflow details.
✨ Features
- ⚡ 46ms reads — SQLite caching gives 30–60x faster reads than bridge-only servers
- 🛠️ 11 MCP tools — lookups, filtered lists, task creation & editing
- 🤖 Agent-first design — warnings that teach, errors that educate, guidance in every response
- 🧪 2,561 tests, 97% coverage — strict mypy, no corners cut
- 🛡️ Graceful degradation — server stays alive no matter what, always recoverable
- 🔄 Automatic fallback — SQLite → OmniJS bridge when needed
See the full documentation for architecture details, examples, and deep dives.
🛠️ Available Tools
Lookups
| Tool | Description |
|---|---|
get_all |
Full OmniFocus database as structured data (last-resort debugging) |
get_task |
Single task by ID — urgency, availability, dates, tags, parent, project |
get_project |
Single project by ID — status, review interval, next task |
get_tag |
Single tag by ID — availability, parent hierarchy |
List & Filter
| Tool | Description |
|---|---|
list_tasks |
Filter by date, availability, flags, tags, project, parent subtree, search — with pagination, field selection, and presence-flag derivation |
list_projects |
Filter by status, folder, review schedule, flags |
list_tags |
List tags with parent hierarchy |
list_folders |
List folders with parent hierarchy |
list_perspectives |
List custom perspectives |
Write
| Tool | Description |
|---|---|
add_tasks |
Create tasks with full field control — parent, tags, dates, flags, notes, repetition rules, parallel/sequential, completes-with-children |
edit_tasks |
Patch semantics — update fields, move tasks, complete/drop, manage tags, repetition rules, and hierarchy properties |
All read tools are idempotent. Write tools reference projects and tags by name or ID.
🔍 Tool Examples
Filter tasks (list_tasks):
{
"query": {
"flagged": true,
"due": "soon",
"availability": "remaining",
"include": ["notes"],
"limit": 10
}
}
Create a task (add_tasks):
{
"items": [{
"name": "Review Q3 roadmap",
"parent": "Work Projects",
"tags": ["Planning"],
"dueDate": "2026-03-15T17:00:00",
"flagged": true,
"estimatedMinutes": 30,
"note": "Focus on v1.3-v1.5 milestones"
}]
}
Edit with patch semantics (edit_tasks):
{
"items": [{
"id": "oRx3bL_UYq7",
"dueDate": null,
"actions": {
"tags": {"add": ["Urgent"]},
"move": {"ending": "Work Projects"}
}
}]
}
Patch semantics cheat sheet:
| Input | Meaning |
|---|---|
| Field omitted | No change |
Field set to null |
Clear the value |
| Field set to a value | Update |
🗺️ Roadmap
| Version | Focus |
|---|---|
| v1.0 | Foundation — read tools, three-layer arch, test suite ✅ |
| v1.1 | Performance — SQLite caching, 30–60x speedup ✅ |
| v1.2 | Writes & Lookups — add/edit tasks, get-by-ID ✅ |
| v1.2.1 | Architectural Cleanup — contracts, service refactor, golden master tests ✅ |
| v1.2.2 | FastMCP v3 Migration ✅ |
| v1.2.3 | Repetition Rule Write Support ✅ |
| v1.3 | Read Tools — SQL filtering, list/count, 5 new tools ✅ |
| v1.3.1 | First-Class References — name resolution, $inbox, rich refs ✅ |
| v1.3.2 | Date Filtering — 7 dimensions, shortcuts, calendar math ✅ |
| v1.3.3 | Task Ordering — dotted notation, outline order ✅ |
| v1.4 | Response Shaping & Batch Processing ✅ |
| v1.4.1 | Task Properties & Subtree — presence flags, auto-complete, parallel/sequential, parent filter ✅ |
| v1.4.2 | UNTIL Format Hotfix — parser accepts RFC 5545 DATE form; builder aligns with OmniFocus UI ✅ |
| v1.4.3 | First-Run UX — welcome banners in bridge.js that frame OmniFocus's permission dialog with two-click instructions; startup log line ✅ |
| v1.4.4 | Batch Limit Increase — add_tasks / edit_tasks accept up to 150 items per call ✅ |
| v1.4.5 | FastMCP Version Cap — dependency capped below 3.4 to restore agent-facing validation errors ✅ |
| v1.4.6 | Startup Access Errors — macOS privacy blocks no longer crash the server; tool calls explain the fix ✅ |
| v1.4.7 | FastMCP 4 — runs on FastMCP 4; agent-facing validation errors restored on current FastMCP ✅ |
| v1.5 | Project Writes — add/edit projects, review marking |
| v1.6 | UI & Perspectives — perspective switching, deep links |
| v1.7 | Smart Perspective Content — perspective-aware response shapes |
| v1.8 | Production Hardening — retry, crash recovery, serial execution |
🔗 Links
- 📖 Full Documentation — features, architecture, examples
- 📦 PyPI — package page
- 🐛 Issues
- 💬 Discussions
📄 License
Proprietary — all rights reserved. Free to use, not to redistribute. License under review.
🤝 Contributing
See CONTRIBUTING.md for guidelines. In short: fork, branch, test, PR.
OmniFocus Operator MCPのよくある質問
OmniFocus Operator MCPが提供するツールは
11個のツールを提供しており、get_all, get_task, get_project, get_tag, list_tasksなどがあります。
OmniFocus Operatorのシステム要件は何ですか?
macOS、OmniFocus 4、およびPython 3.12以降が必要です。
Claude Desktopを使用する際にmacOSのプライバシー制限が発生した場合はどうすればよいですか?
システム設定の「プライバシーとセキュリティ」から、uvxバイナリに「フルディスクアクセス」を許可する必要がある場合があります。
大量のタスクを一度に処理できますか?
はい、add_tasksおよびedit_tasksツールは、1回の呼び出しにつき最大150個のアイテムを受け付けることができます。
手動のインストール手順なしで実行する方法はありますか?
はい、uvxを使用することで、サーバーのダウンロード、分離、実行を自動的に行うことができます。