MCP OmniFocus
Specifically required as the operating system for running OmniFocus and this integration
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP OmniFocus list my tasks due this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-omnifocus
A Model Context Protocol (MCP) server for controlling OmniFocus from VS Code, the command line, or any MCP-compatible client. This tool enables automation and management of your OmniFocus tasks, projects, and tags using natural language and programmable interfaces.
Features
List all tasks, projects, tags, and perspectives in OmniFocus
Create, update, complete, drop, and activate tasks
Assign tasks to projects and tags
Process and organize your GTD inbox
Integrate with VS Code and other MCP clients
Related MCP server: OmniFocus MCP Server
Requirements
Installation
Clone the repository and install dependencies using uv:
git clone https://github.com/YOUR_USERNAME/mcp-omnifocus.git
cd mcp-omnifocus
uv venv
uv pip install -e .Usage
Add the following to your mcp configuration:
{
"servers": {
"mcp-omnifocus": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/somposer/mcp-omnifocus",
"mcp-omnifocus",
]
}
}
}Capabilities
The MCP OmniFocus server exposes the following tools, prompts, and resources:
list_perspectives: List all perspectiveslist_projects: List all projectslist_tags: List all tagslist_tasks: List all tasks (with full hierarchy)list_inbox: List all tasks in the Inboxcreate_task: Create a new taskupdate_task: Update a task (name, project, tags, note, defer/due date, flagged)complete_task: Mark a task as completedrop_task: Drop a taskactivate_task: Reactivate a dropped or completed taskprocess_inbox: A reusable prompt for processing your GTD inbox
Development
For development change your mcp.json to the following:
{
"servers": {
"mcp-omnifocus": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--project",
"${workspaceFolder}/",
"python",
"-m",
"mcp_omnifocus",
],
"dev": {
"watch": "src/**/*.py",
"debug": {
"type": "python"
}
}
}
}
}License
MIT
Available Tools
12 toolsactivate_taskA
Activate (un-drop or un-complete) a task in OmniFocus.
Inputs: task_id (required).
complete_taskC
Complete a task in OmniFocus.
Inputs: task_id (required).
create_taskC
Create a new task in OmniFocus with a name and an optional note.
Inputs: name (required), note.
drop_taskC
Drop a task in OmniFocus.
Inputs: task_id (required).
list_inboxB
List all tasks in the OmniFocus Inbox.
Inputs: no named parameters.
list_perspectivesB
List all perspectives in OmniFocus.
Inputs: no named parameters.
list_projectsB
List all projects in OmniFocus.
Inputs: no named parameters.
list_tagsB
List all tags in OmniFocus.
Inputs: no named parameters.
list_tasksB
List all tasks in OmniFocus. The task full name is the full heirarchy of the task, including parent tags.
Inputs: no named parameters.
list_tasks_by_projectC
List all tasks in a specific project.
Inputs: project_id (required), task_status.
list_tasks_by_tagC
List all tasks with a specific tag.
Inputs: tag_id (required), task_status.
update_taskC
Update a task in OmniFocus with a new name, assigned project name, tags, note, due date, and/or defer date.
Inputs: task_id (required), defer_date, due_date, flagged, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have distinct purposes, but there is some overlap between 'list_tasks' and the more specific 'list_tasks_by_project' and 'list_tasks_by_tag', which could cause confusion if an agent needs to choose between general and filtered listing. However, the descriptions clarify the differences, preventing major misselection.
All tool names follow a consistent verb_noun pattern with snake_case, such as 'create_task', 'list_inbox', and 'update_task'. This predictability makes the tool set easy to navigate and understand at a glance.
With 12 tools, the server is well-scoped for managing OmniFocus tasks, covering key operations like create, update, complete, and list across inbox, projects, and tags. Each tool serves a clear purpose without redundancy, fitting typical task management workflows.
The tool set provides strong CRUD coverage for tasks (create, update, complete, drop, activate) and comprehensive listing options (inbox, projects, tags, perspectives). A minor gap is the lack of direct project or tag management tools (e.g., create_project), but agents can still handle core task operations effectively.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) server that integrates with OmniFocus to enable Claude (or other MCP-compatible AI assistants) to interact with your tasks and projects.7902 npm254MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that integrates OmniFocus with Claude Desktop, providing AI-powered access to tasks and projects for enhanced task management and weekly reviews.48MIT
- FlicenseNot gradedqualityBmaintenanceA production-grade MCP server that exposes OmniFocus as structured task infrastructure for AI agents, enabling read, write, and filter operations on tasks and projects via natural language.11-
- AlicenseNot gradedqualityDmaintenanceMCP server that gives AI assistants full control over OmniFocus on macOS, including tasks, projects, tags, folders, perspectives, forecast, notifications, and review workflows.44MIT