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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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

OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
28
Python
Context Manager MCP Server
docherty
-
security
A
license
-
quality
A server implementation of the Model Context Protocol (MCP) for managing development workflow with features like project management, task tracking, and QA review support.
Last updated -
JavaScript
AGPL 3.0
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
25
15
TypeScript
Task Manager MCP Server
tradesdontlie
-
security
A
license
-
quality
A Model Context Protocol server providing comprehensive task management capabilities with support for project organization, task tracking, and automatic PRD parsing into actionable items.
Last updated -
4
Python
MIT License

View all related MCP servers

MCP OmniFocus

mcp-omnifocus

Features

Requirements

Installation

Usage

Capabilities

Development

License

Related MCP Servers

OpenAI MCP Server

Context Manager MCP Server

OmniFocus-MCP

Task Manager MCP Server

New MCP Servers

MCP directory API