Omnifocus MCP

The OmniFocus MCP Server is a bridge that connects an AI assistant with the OmniFocus task management system, enabling viewing, creation, editing, and deletion of tasks through natural language interaction.

Schedule management Artificial intelligence chatbots #Task Management #AI Integration #Automation Tool .TypeScript

rating : 2.5 points

downloads : 31

update time : 2025-04-28

What is the OmniFocus MCP Server?

The OmniFocus MCP Server is a bridge that connects an AI assistant (such as Claude) with the OmniFocus task management system. It allows you to operate your tasks, projects, and tags through natural language, such as adding, editing, or deleting tasks.

How to use the OmniFocus MCP Server?

By configuring the Claude desktop client and starting the server, you can easily interact with OmniFocus for efficient task management and automation.

Applicable Scenarios

The OmniFocus MCP Server is suitable for users who need to quickly create tasks, organize projects, or process tasks in batches, especially for team collaboration or complex project management.

Main Features

Get Database StatusView all tasks and projects in the current OmniFocus database.

Add TaskAdd a new task to OmniFocus and support setting attributes such as name, tag, and priority.

Add ProjectCreate a new project and add it to a specified folder.

Remove Task or ProjectRemove a specific task or project based on ID or name.

Batch ProcessingAdd or remove multiple tasks or projects at once to improve efficiency.

Advantages and Limitations

Advantages

Seamlessly integrate OmniFocus with an AI assistant to boost productivity.

Support complex batch operations to reduce repetitive labor.

An intuitive natural language interface to lower the learning curve.

Limitations

Require macOS environment and OmniFocus software support.

Some advanced features may require additional configuration.

Users unfamiliar with AI tools may need some time to adapt.

How to Use

Install Dependencies

Ensure Node.js is installed and globally install the MCP SDK.

Configure Claude

Configure the OmniFocus MCP Server in the Claude desktop client.

Start Using

Interact with OmniFocus through natural language to perform task management operations.

Usage Examples

Batch Create TasksAutomatically convert action items in meeting notes into OmniFocus tasks.

Organize Task TagsCheck all tasks without an energy level tag and suggest appropriate tags.

Frequently Asked Questions

What system requirements does the OmniFocus MCP Server have?

How to add tasks in batches?

Does it support other AI assistants?

Related Resources

OmniFocus MCP GitHub Repository

The location for source code and documentation.

Claude Official Documentation

Learn how to configure the Claude client.

OmniFocus Official Website

Learn more about the features of OmniFocus.

🚀 OmniFocus MCP Server

An MCP (Model Context Protocol) server integrated with OmniFocus, enabling Claude (or other MCP-compatible AI assistants) to interact with its tasks and projects through natural language conversations.

🚀 Quick Start

Prerequisites

A macOS system with OmniFocus installed

Connecting to Claude

In Claude Desktop, add this MCP server to the configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "omnifocus": {
      "command": "npx",
      "args": ["-y", "omnifocus-mcp"]
    }
  }
}

Start Claude and connect to the new OmniFocus MCP server.

✨ Features

This MCP server bridges the gap between an AI assistant (such as Claude) and your OmniFocus task management system. It empowers the AI model to view, create, edit, and delete tasks and projects in the OmniFocus database.

Some use cases include:

Convert a course syllabus PDF into a full-fledged project with specific tasks, tags, defer dates, and due dates.
Transform meeting notes into an action list.
Create visualizations of tasks, projects, and tags in OmniFocus.
Handle multiple tasks or projects at once.
Efficiently manage your OmniFocus projects in bulk.

📦 Installation

Basic Tools

# Install the npm package (if needed)
npm install -g @omnifocus/mcp-server

Starting the Server

omni-mcp-server

💻 Usage Examples

Adding a Task

{
  "command": "add_task",
  "params": {
    "name": "Complete the project report",
    "dueDate": "2024-03-25T17:00:00Z",
    "projectName": "Work"
  }
}

Getting All Projects

{
  "command": "get_projects"
}

List of Tools

add_task: Add a new task to a specified project.
add_project: Create a new project and add it to the OmniFocus database.
delete_task: Delete a specific task by its ID.
complete_task: Complete and mark a task as done.
update_task: Update the attributes of an existing task.
search: Search for tasks and projects in the database.
export_data: Export OmniFocus data to a JSON file.

Development Guide

Installing Dependencies

npm install @omnifocus/mcp-server

Starting the Development Server

npx mcp-server start

Debug Mode

DEBUG=omni-mcp-server npm start

🔧 Technical Details

The server uses AppleScript to communicate with OmniFocus, allowing it to access the application's native features. It is built using the Model Context Protocol (MCP) SDK, which provides a standardized way for AI models to interact with external tools and systems.