OmniFocus MCP
MCP server that gives AI assistants full control over OmniFocus on macOS.
Power your agent
Cài đặt từ nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
Chưa có bản phát hành đóng gói nào trong registry. Làm theo README của kho mã.
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên 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.
MởTừ nhà phát hành
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
Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
OmnifocusMCP chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-10-28. Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations