OmniFocus MCP
MCP server that gives AI assistants full control over OmniFocus on macOS.
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
MCP server that gives AI assistants full control over OmniFocus on macOS.
Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations
45 tools, 3 resources, and 4 prompts covering tasks, projects, tags, folders, perspectives, forecast, notifications, and review workflows — all through the Model Context Protocol.
This project is not affiliated with, endorsed by, or associated with The Omni Group or OmniFocus. OmniFocus is a trademark of The Omni Group. This is an independent, non-commercial open-source project.
Install via Homebrew (if you don't have Homebrew, see the Homebrew installation guide):
brew tap vitalyrodnenko/omnifocus-mcp
brew install omnifocus-mcp
Then add to your MCP client config (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"omnifocus": {
"command": "omnifocus-mcp",
"args": []
}
}
}
That's it. The AI assistant now has full OmniFocus access.
Full lifecycle management for OmniFocus tasks:
list_tasks and search_tasks support powerful filter combinations:
All list/search tools support sortBy and sortOrder:
name, dueDate, deferDate, completionDate, estimatedMinutes, project, flagged, addedDate, changedDate, plannedDateadded -> addedDate, modified -> changedDate, planned -> plannedDateasc (default) or descaddedDate and changedDate (ISO 8601 or null)complete_project when work is finished/closed (done/completed).set_project_status for organizational state only:
active = currenton_hold = paused (UI wording is often "on hold"/"on-hold")dropped = intentionally abandoned/cancelled, not completeduncomplete_project to reopen a completed project back to active.Live snapshots available to MCP clients:
Ready-to-use review workflows:
Three implementations with identical tool names, parameters, and response shapes:
Detailed setup guides: Rust · Python · TypeScript
The server runs JXA (JavaScript for Automation) scripts through macOS osascript. Each script uses the OmniFocus evaluateJavascript bridge to execute Omni Automation JavaScript inside OmniFocus itself, where full APIs like flattenedTasks, Task.Status, and new Task() are available. Data is serialized as JSON and returned through the MCP protocol with consistent schemas across all three implementations.
{
"mcpServers": {
"omnifocus": {
"command": "omnifocus-mcp",
"args": []
}
}
}
{
"mcpServers": {
"omnifocus": {
"command": "omnifocus-mcp",
"args": []
}
}
}
{
"mcpServers": {
"omnifocus": {
"command": "uv",
"args": ["run", "omnifocus-mcp"]
}
}
}
{
"mcpServers": {
"omnifocus": {
"command": "node",
"args": ["dist/index.js"],
"cwd": "/absolute/path/to/OmnifocusMCP/typescript"
}
}
}
Keep only one OmniFocus MCP server enabled at a time to avoid duplicate tool surfaces.
Compatibility snippet:
{
"mcpServers": {
"omnifocus": {
"command": "python",
"args": ["-m", "omnifocus_mcp"]
}
}
}
{
"mcpServers": {
"omnifocus": {
"command": "node",
"args": ["dist/index.js"],
"cwd": "/absolute/path/to/OmnifocusMCP/typescript"
}
}
}
omnifocus-mcp binary.uv or python -m execution and fast local iteration.node execution from typescript/dist/index.js.For source builds only:
Contributions are welcome through focused pull requests with clear scope and passing checks. See CONTRIBUTING.md for setup and validation steps.
MIT. See LICENSE for details.
Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
OmnifocusMCP läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations