OmniFocus를 Claude 및 기타 MCP 호환 AI 어시스턴트와 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

이 서버는 AI 비서와 OmniFocus 데이터베이스를 연결해 줍니다. 자연스러운 대화를 통해 비서는 조회, 생성, 편집, 작업 및 프로젝트 삭제를 할 수 있으며, 대량 작업도 포함됩니다. 이 서버로 할 수 있는 몇 가지 일:

• 강의 계획서 PDF를 작업, 태그, 연기 날짜, 마감일이 포함된 완전히 지정된 프로젝트로 번역
• 회의 기록을 행동 목록으로 전환하기
• 태그, 프로젝트, 폴더를 대화식으로 감사하고 재구성하기
• 작업, 프로젝트, 태그의 시각화 생성
• 한 번의 배치 작업으로 수십 개의 품목을 처리합니다

퀵 스타트

전제 조건

• OmniFocus가 설치된 macOS
• Node.js 20 이상 (npx의 경우)

서버가 OmniFocus와 처음 통신할 때, macOS는 자동화 접근 권한을 요청합니다. 한 번 허용하면 바로 가능합니다.

클로드 데스크탑

서버를 ~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

그 다음 Claude Desktop을 재시작하세요.

클로드 코드

다른 MCP 클라이언트들도 마찬가지로 작동합니다: stdio를 통해 [npx -y omnifocus-mcp를 실행합니다.

예시 대화

타겟 쿼리:

OmniFocus MCP Server

A Model Context Protocol (MCP) server that connects OmniFocus to Claude and other MCP-compatible AI assistants.

Overview

This server bridges AI assistants and your OmniFocus database. Through natural conversation, an assistant can query, create, edit, and remove tasks and projects — including bulk operations. Some things you can do with it:

• Translate a syllabus PDF into a fully specified project with tasks, tags, defer dates, and due dates
• Turn a meeting transcript into a list of actions
• Audit and reorganize your tags, projects, and folders conversationally
• Create visualizations of your tasks, projects, and tags
• Process dozens of items in a single batch operation

Quick Start

Prerequisites

• macOS with OmniFocus installed
• Node.js 20 or later (for npx)

The first time the server talks to OmniFocus, macOS will ask you to allow automation access. Grant it once and you’re set.

Claude Desktop

Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Then restart Claude Desktop.

Claude Code

claude mcp add omnifocus -- npx -y omnifocus-mcp

Other MCP clients work the same way: launch npx -y omnifocus-mcp over stdio.

Example Conversations

Targeted queries:

“Show me all my flagged tasks due this week”

“What are my next actions in the Work folder?”

“Count how many tasks are in each project”

Reorganizing:

“I want every task to have an energy level tag. Show me a list of all the tasks that don’t have one and your suggestions for what tag to add. I’ll make any changes I think are appropriate. Then make the changes in OmniFocus.”

Capturing from anywhere:

“Ok, thanks for the detailed explanation of why the rule of law is important. Add a recurring task to my activism project that reminds me to call my representative weekly. Include a summary of this conversation in the notes field.”

Working with perspectives:

“What perspectives do I have available?”

“Show me what’s in my Inbox perspective”

Processing transcripts or PDFs:

“I’m pasting in the transcript from today’s meeting. Please analyze it and create tasks in OmniFocus for any action items assigned to me. Put them in my ‘Product Development’ project.”

Tools

The server provides 12 tools. Optional parameters are marked.

query_omnifocus