OmniFocus MCP
MCP server that gives AI assistants full control over OmniFocus on macOS.
Potencia tu agente
Instalación del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
Aún no hay una versión empaquetada en el registro. Sigue el README del repositorio.
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
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.
AbrirDel publicador
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
Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
OmnifocusMCP se ejecuta localmente por stdio.
Última comprobación: 2026-10-28. Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations