OmniFocus Operator MCP server
Commit 13 Nov 2026Menghubungkan task, project, dan tag OmniFocus ke AI agent untuk manajemen tugas dan otomatisasi yang terstruktur.
Juga dikenal sebagai HelloThisIsFlo/omnifocus-operator
- Stars
- 11
- Tools
- 11
- Unduhan, 30 hari
- β
- Versi terbaru
- β
- Commit terakhir
- 13 Nov 2026
- Lisensi
- β
Apa itu OmniFocus Operator MCP?
Menghubungkan task, project, dan tag OmniFocus ke AI agent untuk manajemen tugas dan otomatisasi yang terstruktur. Server ini menyediakan 11 tool, seperti get_all, get_task, get_project.
Ringkasan dibuat dari README proyek
Tentang OmniFocus Operator MCP server
Server ini memungkinkan pengguna macOS untuk mengelola daftar tugas yang kompleks dan hierarki project melalui AI agent. Server ini menghubungkan OmniFocus 4 ke client MCP seperti Claude Desktop, Claude Code, atau Cursor, sehingga agent dapat berinteraksi langsung dengan data produktivitas pribadi Anda. Dengan menggunakan uvx untuk menjalankan server, Anda dapat mengintegrasikan infrastruktur tugas yang sudah ada dengan cepat tanpa proses instalasi manual.
Server ini menyediakan 11 tool khusus untuk mencari task, project, atau tag tertentu, serta untuk memfilter daftar besar berdasarkan tanggal, flag, atau ketersediaan. Server ini juga mendukung operasi penulisan, yang berarti agent dapat membuat task baru dengan kontrol field penuh atau mengedit task yang sudah ada menggunakan patch semantics untuk memperbarui catatan, memindahkan item antar project, atau mengelola aturan repetisi.
Performa menjadi fokus utama, dengan memanfaatkan caching SQLite untuk mencapai kecepatan baca 46ms, yang jauh lebih cepat daripada implementasi bridge standar. Sistem ini dirancang untuk reliabilitas, dilengkapi dengan fallback otomatis ke OmniJS bridge dan graceful degradation untuk memastikan server tetap dapat dipulihkan selama penggunaan.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool OmniFocus Operator MCP 11
Terdeteksi dari READMEget_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 | β |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap βBelum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks Β· Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauhellothisisflo/omnifocus-operator is public and reachablegithub.com/hellothisisflo/omnifocus-operator βLolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-12github.com/hellothisisflo/omnifocus-operator βLolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang OmniFocus Operator MCP
Tool apa yang disediakan OmniFocus Operator MCP?
Server ini menyediakan 11 tool, termasuk get_all, get_task, get_project, get_tag, list_tasks.
Apa saja persyaratan sistem untuk OmniFocus Operator?
Anda memerlukan sistem macOS, OmniFocus 4, dan Python 3.12 atau versi yang lebih tinggi.
Bagaimana cara mengatasi pemblokiran privasi macOS saat menggunakan Claude Desktop?
Anda mungkin perlu memberikan Full Disk Access ke binary uvx di System Settings β Privacy & Security.
Apakah server ini bisa menangani batch tugas dalam jumlah besar?
Ya, tool add_tasks dan edit_tasks dapat menerima hingga 150 item per panggilan.
Apakah ada cara untuk menjalankannya tanpa langkah instalasi manual?
Ya, menggunakan uvx memungkinkan Anda untuk mengunduh, mengisolasi, dan menjalankan server secara otomatis.