omnifocus:get_all_tasksLABSCO SUMMARY
Three read tools, and one of them earns its place.
Nothing here writes, so it cannot reorganise your system by accident — it is for asking questions about what is on your plate. The active-task filter is the part worth having: a raw task dump from a real OmniFocus database is mostly noise, and this one drops the template and system entries before the model sees them.
What it is
A read-only MCP server for OmniFocus on macOS, driven through the official Omni Automation JavaScript API. Its useful trick is the active-task filter: OmniFocus databases accumulate template entries and system items, and the filtered view keeps them out of what the assistant sees.
What you get
- All tasks retrieved with filtering options —
includeCompleted(default false) andlimit(default 100) —omnifocus:get_all_tasks - Only active, uncompleted tasks, with tasks from "Templates" folders, tasks containing the placeholder characters
«and», and tasks marked with the synced-preferences⚙️marker filtered out —omnifocus:get_active_tasks - All active projects —
omnifocus:get_projects
Requirements
macOS with OmniFocus installed, Node.js 23.10.0 or higher, and Claude Desktop. Clone, npm install, npm run build, then point the Claude Desktop config at run-server.sh in the project directory. On first run macOS prompts for automation permission for OmniFocus — click Allow; if the prompt does not appear, the README explains temporarily uncommenting the osascript lines in run-server.sh to trigger it. Package omnifocus-mcp 1.0.0.
Setup effort
Build from source — git clone https://github.com/mdoel/omnifocus-mcp
USE CASES
01
Getting a clean view of what is actually open
Pull the active tasks so template entries and system items are already gone rather than filtered by hand.
02
Running a weekly review with an assistant
Pull projects and active tasks together and talk through what has stalled.
03
Looking back at what you finished
Request all tasks with completed ones included and raise the limit past its default.
3 tools
Listed in project docs. Your client may show a different list.
omnifocus:get_active_tasksomnifocus:get_projectsBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
Node.js 23.10.0 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/mdoel/omnifocus-mcp
cd omnifocus-mcp
npm install
npm run build
chmod +x run-server.shOpen run-server.sh and change the Node path on its last line (/Users/mdoel/.asdf/installs/nodejs/23.10.0/bin/node) to your own Node.js 23.10.0+ binary — which node prints it.
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"omnifocus": {
"command": "<YOUR_PATH_TO_OMNIFOCUS_MCP>/run-server.sh",
"args": []
}
}
}
