OmniFocus Operator MCP server
2026년 11월 13일 커밋OmniFocus의 작업, 프로젝트, 태그를 AI agent에 노출하여 구조화된 작업 관리 및 자동화를 지원합니다.
다른 이름 HelloThisIsFlo/omnifocus-operator
- 스타
- 11
- Tools
- 11
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- —
OmniFocus Operator MCP란?
OmniFocus의 작업, 프로젝트, 태그를 AI agent에 노출하여 구조화된 작업 관리 및 자동화를 지원합니다. 11개 도구를 제공합니다. 예: get_all, get_task, get_project.
프로젝트 README에서 생성된 요약
OmniFocus Operator MCP server 정보
이 서버는 macOS 사용자가 AI agent를 통해 복잡한 작업 목록과 프로젝트 계층 구조를 관리할 수 있도록 지원합니다. OmniFocus 4를 Claude Desktop, Claude Code 또는 Cursor와 같은 MCP client에 연결하여, agent가 사용자의 개인 생산성 데이터와 직접 상호작용할 수 있게 합니다. uvx를 사용하여 서버를 실행하면 별도의 수동 설치 과정 없이 기존 작업 인프라를 빠르게 통합할 수 있습니다.
이 서버는 특정 작업, 프로젝트 또는 태그를 조회하고 날짜, 플래그 또는 가용성에 따라 대량의 목록을 필터링할 수 있는 11개의 특화된 도구를 제공합니다. 쓰기 작업도 지원하므로, agent가 모든 필드를 제어하여 새 작업을 생성하거나 patch semantics를 사용하여 기존 작업의 메모를 업데이트하고, 프로젝트 간 항목 이동 또는 반복 규칙을 관리하는 등의 편집 작업을 수행할 수 있습니다.
성능을 핵심 가치로 삼아 SQLite 캐싱을 활용함으로써 46ms의 읽기 속도를 구현했으며, 이는 일반적인 bridge 전용 구현보다 훨씬 빠릅니다. 또한 시스템의 신뢰성을 위해 OmniJS bridge로 자동 폴백(fallback)하는 기능과 사용 중 서버가 복구 가능한 상태를 유지하도록 하는 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 도구는 호출당 최대 150개의 항목을 처리할 수 있습니다.
수동 설치 단계 없이 실행할 수 있는 방법이 있나요?
네, uvx를 사용하면 서버를 자동으로 다운로드, 격리 및 실행할 수 있습니다.