MCP OmniFocus

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

macOS with OmniFocus installed
Python 3.12+
uv for fast Python package management

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 perspectives
list_projects: List all projects
list_tags: List all tags
list_tasks: List all tasks (with full hierarchy)
list_inbox: List all tasks in the Inbox
create_task: Create a new task
update_task: Update a task (name, project, tags, note, defer/due date, flagged)
complete_task: Mark a task as complete
drop_task: Drop a task
activate_task: Reactivate a dropped or completed task
process_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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all 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

OmniFocus-MCP
themotionmachine
A
security
F
license
A
quality
A 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
422
61
TypeScript
OmniFocus MCP Server
mdoel
A
security
A
license
A
quality
A 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 -
4
422
3
TypeScript
MIT License
Conduit
mcpnow-io
-
security
A
license
-
quality
A 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 -
4
Python
MIT License
OmniFocus MCP Enhanced
jqlts1
A
security
F
license
A
quality
Enhanced 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 -
16
3
5
TypeScript

View all related MCP servers

MCP OmniFocus

mcp-omnifocus

Features

Requirements

Installation

Usage

Capabilities

Development

License

Tools

Related MCP Servers

OmniFocus-MCP

OmniFocus MCP Server

Conduit

OmniFocus MCP Enhanced

New MCP Servers

MCP directory API