MCP server OmniFocus Operator
Коммит 13 нояб. 2026 г.Предоставляет доступ к задачам, проектам и тегам OmniFocus для AI-агентов с целью структурированного управления задачами и автоматизации.
Также известен как HelloThisIsFlo/omnifocus-operator
- Звёзды
- 11
- Инструменты
- 11
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- —
Что такое OmniFocus Operator MCP?
Предоставляет доступ к задачам, проектам и тегам OmniFocus для AI-агентов с целью структурированного управления задачами и автоматизации. Он предоставляет 11 инструментов, например get_all, get_task, get_project.
Сводка сгенерирована из README проекта
О OmniFocus Operator MCP server
Этот сервер позволяет пользователям macOS управлять сложными списками задач и иерархиями проектов через AI-агентов. Он подключает OmniFocus 4 к MCP-клиентам, таким как Claude Desktop, Claude Code или Cursor, позволяя агенту напрямую взаимодействовать с вашими персональными данными о продуктивности. Благодаря использованию uvx для запуска сервера вы можете быстро интегрировать существующую инфраструктуру задач без процесса ручной установки.
Сервер предоставляет 11 специализированных инструментов для поиска конкретных задач, проектов или тегов, а также для фильтрации больших списков по датам, флагам или доступности. Он поддерживает операции записи, что означает, что агент может создавать новые задачи с полным контролем полей или редактировать существующие, используя семантику patch для обновления заметок, перемещения элементов между проектами или управления правилами повторения.
Производительность является ключевым приоритетом: использование кэширования SQLite позволяет достигать скорости чтения в 46 мс, что значительно быстрее стандартных реализаций, работающих только через bridge. Система спроектирована с упором на надежность и включает автоматический переход на OmniJS bridge и механизмы постепенного снижения функциональности (graceful degradation), чтобы обеспечить восстановимость сервера во время работы.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Инструменты OmniFocus Operator MCP 11
Определено из 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 | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийhellothisisflo/omnifocus-operator is public and reachablegithub.com/hellothisisflo/omnifocus-operator ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний год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 или выше.
Как исправить блокировки конфиденциальности macOS при использовании Claude Desktop?
Возможно, вам потребуется предоставить полный доступ к диску (Full Disk Access) для бинарного файла uvx в разделе Системные настройки → Конфиденциальность и безопасность.
Может ли сервер обрабатывать большие пакеты задач?
Да, инструменты add_tasks и edit_tasks могут принимать до 150 элементов за один вызов.
Можно ли запустить это без ручной установки?
Да, использование uvx позволяет автоматически скачивать, изолировать и запускать сервер.