omnifocus-mcp

bruvik/omnifocus-mcp

3.2

If you are the rightful owner of omnifocus-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

OmniFocus MCP Server is a FastAPI server that provides access to OmniFocus inbox tasks through a simple MCP-friendly API, utilizing AppleScript for task management.

OmniFocus MCP Server

FastAPI server that exposes OmniFocus tasks to Model Context Protocol (MCP) hosts via AppleScript.

Prerequisites

  • macOS with OmniFocus installed
  • Python 3.11+

Setup

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run the server

uvicorn server:app --reload

Endpoints

  • GET /health – simple healthcheck
  • GET /mcp/listTasks – returns {"tasks": [...]} from scripts/list_tasks.applescript
  • POST /mcp/addTask – body {"title": "...", "project": "optional"}; delegates to scripts/add_task.applescript

AppleScript helpers

The server shells out to osascript to call the scripts in scripts/. You can test them directly:

osascript scripts/list_tasks.applescript
osascript scripts/add_task.applescript "Pick up milk" "Home"