PlugWiki
OmniFocus-MCP logo

OmniFocus MCP Server (OmniFocus-MCP)

CommunityLocal

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.

Install OmniFocus MCP

Claude Code

  1. 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. 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_omnifocus

  • Shows 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_view

  • Reads 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_database

  • Adds 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_task

  • Creates 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_project

  • Creates 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_items

  • Changes, 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_item

  • Deletes 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_item

  • Deletes 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_items

  • Lists 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_tags

  • Creates 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_tag

  • Lists 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 keysNo account or key; macOS asks once to let it control OmniFocus.
Scopes
  • Your entire local OmniFocus database: tasks, projects, folders, tags and perspectives

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.

ServerOfficialRunsCan change thingsToolsGitHub stars
OmniFocus-MCPThis pageCommunityLocalYes12251
omnifocus-mcp-enhancedCommunityLocal––65
illyastarikov omnifocus-mcpCommunityLocal––22
s-morgan-jeffries omnifocus-mcpCommunityLocalYes–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

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

    Source
  • Next actions in a folder

    What are my next actions in the Work folder?

    Source
  • Turn 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.

    Source
  • Count tasks per project

    Count how many tasks are in each project

    Source
  • Check 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

GitHubnpmChangelogIssues

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 6
  1. themotionmachine/OmniFocus-MCP · github.com
  2. Omni Roadmap 2026 — Post-WWDC Update · omnigroup.com
  3. Suggestion: Project scoping · github.com
  4. Omnifocus MCP for a Claude Extension · talk.macpowerusers.com
  5. Shim idle backstop disconnects live-but-quiet stdio clients · github.com
  6. Omnifocus MCP Server · discourse.omnigroup.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.