OmniFocus Operator MCP sunucusu
Commit 13 Kas 2026OmniFocus görevlerini, projelerini ve etiketlerini yapılandırılmış görev yönetimi ve otomasyon için AI agent'larına açar.
Ayrıca bilinen adı HelloThisIsFlo/omnifocus-operator
- Yıldızlar
- 11
- Araçlar
- 11
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 13 Kas 2026
- Lisans
- —
OmniFocus Operator MCP nedir?
OmniFocus görevlerini, projelerini ve etiketlerini yapılandırılmış görev yönetimi ve otomasyon için AI agent'larına açar. 11 araç sunar; örneğin get_all, get_task, get_project.
Özet, projenin README dosyasından oluşturuldu
OmniFocus Operator MCP sunucusu hakkında
Bu sunucu, macOS kullanıcılarının karmaşık görev listelerini ve proje hiyerarşilerini AI agent'ları aracılığıyla yönetmesini sağlar. OmniFocus 4'ü Claude Desktop, Claude Code veya Cursor gibi MCP istemcilerine bağlayarak bir agent'ın kişisel verimlilik verilerinizle doğrudan etkileşime girmesine olanak tanır. Sunucuyu çalıştırmak için uvx kullanarak, mevcut görev altyapınızı manuel bir kurulum sürecine gerek duymadan hızlıca entegre edebilirsiniz.
Sunucu; belirli görevleri, projeleri veya etiketleri sorgulamak; büyük listeleri tarihlere, bayraklara (flags) veya uygunluk durumuna göre filtrelemek için 11 özelleşmiş araç sunar. Yazma işlemlerini de destekler; bu da bir agent'ın tam alan kontrolüyle yeni görevler oluşturabileceği veya notları güncellemek, öğeleri projeler arasında taşımak veya tekrarlama kurallarını yönetmek için patch semantiği kullanarak mevcut görevleri düzenleyebileceği anlamına gelir.
Performans temel odak noktasıdır; SQLite önbelleğe alma kullanarak 46ms okuma sürelerine ulaşır ki bu, standart bridge tabanlı uygulamalardan önemli ölçüde daha hızlıdır. Sistem, OmniJS bridge yapısına otomatik geri dönüş (fallback) ve kullanım sırasında sunucunun kurtarılabilir kalmasını sağlayan kademeli işlev kaybı (graceful degradation) özellikleri ile güvenilirlik için tasarlanmıştır.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
OmniFocus Operator MCP araçları 11
README dosyasından algılandı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 | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirhellothisisflo/omnifocus-operator is public and reachablegithub.com/hellothisisflo/omnifocus-operator ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-12github.com/hellothisisflo/omnifocus-operator ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
🎯 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 soruları
OmniFocus Operator MCP hangi araçları sunar?
11 araç sunar; bunlar arasında get_all, get_task, get_project, get_tag, list_tasks yer alır.
OmniFocus Operator için sistem gereksinimleri nelerdir?
macOS işletim sistemi, OmniFocus 4 ve Python 3.12 veya üzeri bir sürüme ihtiyacınız vardır.
Claude Desktop kullanırken macOS gizlilik engellerini nasıl düzeltebilirim?
Sistem Ayarları → Gizlilik ve Güvenlik kısmından uvx binary dosyasına Tam Disk Erişimi (Full Disk Access) vermeniz gerekebilir.
Sunucu büyük görev gruplarını işleyebilir mi?
Evet, add_tasks ve edit_tasks araçları her çağrıda 150 öğeye kadar kabul edebilir.
Bunu manuel kurulum adımı olmadan çalıştırmanın bir yolu var mı?
Evet, uvx kullanarak sunucuyu otomatik olarak indirebilir, izole edebilir ve çalıştırabilirsiniz.