MCP OmniFocus

mcp全聚焦

一种用于控制的模型上下文协议（MCP）服务器 GTD 软件 从VS Code、命令行或任何兼容MCP的客户端。该工具使用自然语言和可编程接口实现OmniFocus任务、项目和标签的自动化和管理。

特性

• 在OmniFocus中列出所有任务、项目、标签和透视图
• 创建、更新、完成、删除和激活任务
• 将任务分配给项目和标签
• 处理和组织您的GTD收件箱
• 与VS Code和其他MCP客户端集成

需求

• macOS与 GTD 软件 安装
• Python 3.12+
• 紫外线 用于快速Python包管理

安装

使用克隆存储库并安装依赖项 uv:

git clone https://github.com/YOUR_USERNAME/mcp-omnifocus.git
cd mcp-omnifocus
uv venv
uv pip install -e .

用法

将以下内容添加到您的mcp配置中：

{
    "servers": {
        "mcp-omnifocus": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/somposer/mcp-omnifocus",
                "mcp-omnifocus",
            ]
        }
    }
}

能力

MCP OmniFocus服务器提供以下工具、提示和资源：

• list_perspectives：列出所有视角
• list_projects：列出所有项目
• list_tags：列出所有标签
• list_tasks：列出所有任务（具有完整的层次结构）
• list_inbox：列出收件箱中的所有任务
• create_task：创建新任务
• update_task：更新任务（名称、项目、标签、注释、推迟/到期日期、标记）
• complete_task：将任务标记为已完成
• drop_task：删除任务
• activate_task：重新激活已删除或已完成的任务
• process_inbox：用于处理GTD收件箱的可重用提示

发展

对于开发，请将您的mcp.json更改为以下内容：

{
    "servers": {
        "mcp-omnifocus": {
            "type": "stdio",
            "command": "uv",
            "args": [
                "run",
                "--project",
                "${workspaceFolder}/",
                "python",
                "-m",
                "mcp_omnifocus",
            ],
            "dev": {
                "watch": "src/**/*.py",
                "debug": {
                    "type": "python"
                }
            }
        }
    }
}

许可证

麻省理工学院