
OmniFocus MCP Server (OmniFocus-MCP)
Lets Claude find, add, edit and clean up your OmniFocus tasks and projects on your Mac, including big batches at once.
This is the most used community server for OmniFocus; the Omni Group does not make one yet. It runs on your Mac and drives the OmniFocus app, so you can ask Claude what is due, add tasks from a meeting transcript or reorganize your tags. It can also delete tasks and projects, and it reaches your whole database, so keep your app's approval prompt on. It only works on a Mac with OmniFocus installed, not from Claude on the web or your phone.
Good for
- OmniFocus users on a Mac who use Claude Desktop or Claude Code
- People who want to turn meeting notes, transcripts or PDFs into OmniFocus tasks
- Anyone tidying up tags, projects and folders by talking it through
- Weekly reviewers who want a quick read of what is due, flagged or overdue
Works in
2 supported · 10 should work
Tap an app to see how to set it up and any known problems.
The README covers it with one command; type @ to attach your inbox, today or flagged lists.
Known problems
- Fixed
Showed the server as failed after 30 quiet minutes
Reported Sep 2026 · GitHub
The README covers it: add the entry to claude_desktop_config.json, restart Claude, then allow automation access. GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install OmniFocus MCP
Claude Code
- 1
Copy this prompt.
Add the OmniFocus MCP server to Claude Code. Run this command: claude mcp add omnifocus -- npx -y omnifocus-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires macOS with OmniFocus installed, Node.js 20 or later.
Read-only mode: There's no read-only mode. Keep your app's setting that asks before each change, especially for deletes.
Type @ in Claude Code to attach your inbox, today, flagged or a project list without a tool call. Allow automation access when macOS asks.
From the project README. Source.
Tools
Finds tasks, projects or folders by due date, tag, flag, status or project
Searches your OmniFocus tasks, projects or folders with filters such as project, folder, tag, status, flagged, or due, deferred, added or completed dates, and returns only the fields you need.
Try: “Show me all my flagged tasks due this week”
Read ·
query_omnifocusShows what is in a perspective, such as Inbox, Flagged or a custom one
Lists the items you would see in a named perspective, built-in like Inbox or Flagged, or one of your custom perspectives.
Try: “Show me what's in my Inbox perspective”
Read ·
get_perspective_viewReads your whole OmniFocus database for a full review
Reads every task, project, folder and tag at once, for big analyses or audits. Completed items and duplicate repeats are hidden by default.
Try: “Look at my whole OmniFocus and tell me which projects have gone stale”
Read ·
dump_databaseAdds a task, with project, dates, tags, notes or a repeat
Creates a task in your inbox or a project, optionally under another task, with a note, due, defer or planned date, flag, time estimate, tags and a repeat schedule.
Try: “Add a weekly task to my activism project reminding me to call my representative”
Write ·
add_omnifocus_taskCreates a project, optionally in a folder
Creates a project, optionally inside a folder, as sequential or parallel, with dates, flag, tags, a note and a repeat schedule.
Try: “Create a sequential project called Kitchen Renovation in my Home folder”
Write ·
add_projectCreates many tasks and projects at once, with subtasks
Creates many tasks and projects in one go, including projects with nested tasks and subtasks, for example from a syllabus or meeting notes.
Try: “Turn this syllabus into a project with a task for every assignment and its due date”
Write ·
batch_add_itemsChanges, completes, moves or reschedules a task or project
Edits a task or project: rename it, change notes, dates, tags or flag, mark it complete or dropped, move it to another project or under another task, change a project's status, folder or review interval, or set a repeat.
Try: “Mark the dentist task as done and move the tax task to next Friday”
Write ·
edit_itemDeletes a task or project
Deletes one task or project. It refuses to delete finished occurrences of repeating items unless told to.
Try: “Delete the task Buy concert tickets”
Delete ·
remove_itemDeletes many tasks or projects at once
Deletes several tasks or projects in one request.
Try: “Delete all the test tasks I created this morning”
Delete ·
batch_remove_itemsLists your tags with how many tasks use each
Lists all your tags with their nesting, whether they are active, and how many tasks use each.
Try: “Which of my tags are unused?”
Read ·
list_tagsCreates a tag, optionally inside another tag
Creates a new tag, optionally nested under an existing tag.
Try: “Create a tag called Low energy under my Energy tag”
Write ·
create_tagLists your built-in and custom perspectives
Lists the perspectives you have, built-in and custom. Custom perspectives need OmniFocus Pro.
Try: “What perspectives do I have available?”
Read ·
list_perspectives
Read from the source code
Pros and cons
Good
- Most starred OmniFocus server, with code updates as recent as September 2026.
- Can query, add, edit, move and delete tasks and projects, including in batches.
- Handles repeating tasks, tags and perspectives.
- Targeted queries keep answers small instead of dumping the whole database.
- Nothing leaves your Mac except what your AI app reads.
- No account, key or sign-in.
Watch out
- Not made by the Omni Group.
- Mac only, with OmniFocus installed; no web or phone use.
- No read-only mode, and no way to limit it to some projects.
- Repeats need OmniFocus 4.7 or later, and some rules are not supported.
- Custom perspectives need OmniFocus Pro.
- Some users found the first install fiddly.
Permissions
medium risk · 4 things to watch
Medium risk
A wrong instruction could delete or rewrite many tasks at once, because it can change anything in your OmniFocus database. Keep your app's setting that asks before each change, and back up OmniFocus before large clean-ups.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete tasks and projects, in bulk
It can remove one item or many in a single request. Keep your app's approval prompt on and read what will be removed before you allow it. github.com
It reaches your whole OmniFocus database
You cannot limit it to certain projects or folders yet. A request for that is open on GitHub. github.com
Past repeats are protected by default
It refuses to edit or delete finished occurrences of repeating tasks unless told to, which keeps repeat chains intact. github.com
Everything stays on your Mac
It talks to OmniFocus through macOS automation and a private local socket, with no network port. Your AI app still sees the tasks it reads. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Sign-in and keys | No account or key; macOS asks once to let it control OmniFocus. |
|---|---|
| Scopes |
|
Alternatives
Use OmniFocus-MCP unless you need something it lacks; it is the most used and most recently updated. There is no official option yet, and every choice runs only on your Mac.
| Server | Official | Runs | Can change things | Tools | GitHub stars |
|---|---|---|---|---|---|
| OmniFocus-MCPThis page | Community | Local | Yes | 12 | 251 |
| omnifocus-mcp-enhanced | Community | Local | – | – | 65 |
| illyastarikov omnifocus-mcp | Community | Local | – | – | 22 |
| s-morgan-jeffries omnifocus-mcp | Community | Local | Yes | – | 8 |
What people say
Users say it works once set up, and many still wish the Omni Group made an official server.
What people like
- Works once set up, and Claude can help fix a misplaced config file
- Lets OmniFocus keep up with AI tools while Omni has no server of its own
Common complaints
- First install is fiddly for some users
- Local-only, so it does not work from Claude on the web or mobile
- Cannot be limited to certain projects
- Users want an official hosted server from the Omni Group
In their words
“That one works for me. It didn’t work at first but I managed to get Claude to troubleshoot it.”nfdksdfkhBlogDec 2025
“It’d be lovely if the omnigroup maintained and served an MCP server as part of our subscription, but I think that’s pretty unlikely to happen.”strickvlBlogJun 2026
“not having an official API/CLI/MCP (aka a convenient way of plugging into an AI agent) makes OF feel like a silo in 2026.”carusoVendorJul 2026
“Some customers have already wired up MCP to all of our apps using our Omni Automation APIs, but we want to make this easier”Ken Case, Omni Group
Questions
Is there an official OmniFocus MCP server?
No. The Omni Group's July 2026 roadmap says it plans first-class MCP support, but gives no date. This server is a community project.
Does it work on iPhone, iPad or Claude on the web?
No. It runs on a Mac with OmniFocus installed and connects to AI apps on that Mac, such as Claude Desktop or Claude Code.
Is it free?
Yes. The server is free and open source under the MIT license. You still need your own OmniFocus license.
Can it delete my tasks?
Yes, one at a time or in bulk. It will not touch finished occurrences of repeating tasks unless asked to.
Can I limit it to certain projects?
Not yet. It can see your whole database; a request to add project limits is open on GitHub.
Why does macOS ask for permission?
It controls OmniFocus through macOS automation. Allow it once when asked and it keeps working.
Does it handle repeating tasks?
Yes, with OmniFocus 4.7 or later. Rules like "third Tuesday" or an end date are not supported, so set those in OmniFocus.
It won't start after install. What should I check?
Check the config file path in the install box and restart your AI app. One user found their config was simply in the wrong place.
What if requests time out?
OmniFocus handles one request at a time. Lower the server's limit on parallel requests, or run it without its shared background process; the README lists both settings.
Examples
See flagged work due this week
Show me all my flagged tasks due this week
SourceNext actions in a folder
What are my next actions in the Work folder?
SourceTurn a meeting transcript into tasks
I'm pasting in the transcript from today's meeting. Please analyze it and create tasks in OmniFocus for any action items assigned to me. Put them in my 'Product Development' project.
SourceCount tasks per project
Count how many tasks are in each project
SourceCheck a perspective
Show me what's in my Inbox perspective
Source
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
omnifocus-mcp- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 1.17.0
- License
- MIT
- Last commit
- Sep 28, 2026
- Open issues
- 6
Other OmniFocus MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 6Hide
- themotionmachine/OmniFocus-MCP · github.com
- Omni Roadmap 2026 — Post-WWDC Update · omnigroup.com
- Suggestion: Project scoping · github.com
- Omnifocus MCP for a Claude Extension · talk.macpowerusers.com
- Shim idle backstop disconnects live-but-quiet stdio clients · github.com
- Omnifocus MCP Server · discourse.omnigroup.com