OmniFocus MCP
MCP server that gives AI assistants full control over OmniFocus on macOS.
Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
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.
BaşlatYayıncıdan
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
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
OmnifocusMCP yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-10-28. Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations