OmniFocus MCP
OmniFocus MCP is an MCP server that lets LLMs interface with your tasks and projects through the Model Context Protocol. It has 250 GitHub stars, is released under the MIT license and runs locally with npx -y omnifocus-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.
github.com/themotionmachine/OmniFocus-MCP (opens in a new tab)
Data as of from the GitHub API; description from the project's repository. Report an error
Install OmniFocus MCP
Generated from the server's published package. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"omnifocus-mcp": {
"command": "npx",
"args": [
"-y",
"omnifocus-mcp"
]
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --transport stdio omnifocus-mcp -- npx -y omnifocus-mcpCursor
{
"mcpServers": {
"omnifocus-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"omnifocus-mcp"
]
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"servers": {
"omnifocus-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"omnifocus-mcp"
]
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Tools (20)
Parsed from the Tools section of the README; check the repository for the current list.
query_omnifocusQuery tasks, projects, or folders with targeted filters — much faster and lighter than dumping the whole database.
entityWhat to query: tasks, projects, or folders
dump_databaseGet the complete state of your database. Use for comprehensive analysis; prefer queryomnifocus for anything targeted.
add_omnifocus_taskCreate a new task.
notedueDate, deferDate, plannedDate, flagged, estimatedMinutes, tags (all optional)
repeat(optional): make it recurring — see Repeating items
add_projectCreate a new project.
sequential(optional): whether tasks must be completed in order
edit_itemEdit an existing task or project. Also the way to move items — set newProjectName to move a task into a project, or to…
positionwithout newParentTaskId reorders the task within its current parent.
remove_itemRemove a task or project.
batch_add_itemsCreate multiple tasks and projects in one operation. Each item accepts the same fields as addomnifocustask /…
batch_remove_itemsRemove multiple tasks or projects in one operation. Each item takes id or name, plus itemType.
list_perspectivesList available perspectives, both built-in and custom (custom perspectives are an OmniFocus Pro feature).
get_perspective_viewGet the items visible in a named perspective.
limit(optional, default: 100), includeMetadata (optional), fields (optional)
list_tagsList all tags with their hierarchy, active status, and task counts.
create_tagCreate a tag, optionally nested under an existing parent.
methodstart-after-completion (counts from when it's actually done), fixed (counts from the calendar regardless), or…
unitday, week, month, or year
About OmniFocus MCP
A Model Context Protocol (MCP) server that connects OmniFocus to Claude and other MCP-compatible AI assistants. This server bridges AI assistants and your OmniFocus database. Through natural conversation, an assistant can query, create, edit, and remove tasks and projects — including bulk operations.
- mcp
- mcp-server
- modelcontextprotocol
- omnifocus
- task-management
Similar MCP servers
More productivity MCP servers
Backlot
brekkylab/backlot
Local emulator for Slack, Gmail, Drive, GitHub, Jira, Notion, S3 and more, with per-document ACLs.
Active · last commit Oct 26, 2026
ProductivityPythonWord MCP Live
ykarapazar/word-mcp-live
Live Microsoft Word editing via MCP — tracked changes, undo, comments, 40+ tools.
Maintained · last commit Oct 6, 2026
ProductivityPythonWord to Markdown
benbalter/word-to-markdown-js
Convert Word (.docx) documents to Markdown via CLI, Node.js, or browser.
Active · last commit Oct 25, 2026
ProductivityTypeScriptGoogle Drive MCP
piotr-agier/google-drive-mcp
Secure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP.
Active · last commit Oct 15, 2026
ProductivityTypeScriptImagesorcery MCP
sunriseapps/imagesorcery-mcp
An MCP server providing tools for image processing operations.
Maintained · last commit May 19, 2026
ProductivityPythonMinerU Open MCP
opendatalab/MinerU-Ecosystem
Parse PDFs, images, doc, docx, ppt, pptx, xls, xlsx, html into Markdown using MinerU API.
Maintained · last commit Sep 22, 2026
ProductivityPython
How do I install the OmniFocus MCP MCP server?
Add the command npx -y omnifocus-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is OmniFocus MCP free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is OmniFocus MCP actively maintained?
The most recent commit was on Sep 28, 2026. The latest release is v1.17.0, published Sep 26, 2026. appsgit only lists MCP servers with a commit in the last six months.