A
securityF
licenseA
qualityA 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.
Last updated -
7
97
86
Specifically required as the operating system for running OmniFocus and this integration
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
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
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Model Context Protocol server that enables automation and management of OmniFocus tasks, projects, and tags using natural language and programmable interfaces from VS Code, command line, or any MCP-compatible client.
Related MCP Servers
- AsecurityAlicenseAqualityA 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.Last updated -4974MIT License
- -securityAlicense-qualityA Model Context Protocol server that integrates with Phabricator and Phorge APIs, enabling developers to automate and interact with task management systems through both synchronous and asynchronous clients.Last updated -4MIT License
- AsecurityFlicenseAqualityEnhanced Model Context Protocol server that transforms OmniFocus into an AI-powered productivity tool with comprehensive task management capabilities including subtask support, perspective views, advanced filtering, and custom perspective access.Last updated -16178