OmniFocus任务管理协议

一个用于通过VS Code、命令行或任何MCP兼容客户端控制OmniFocus的模型上下文协议服务器,支持自动化和管理任务、项目和标签。

  • by someposer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 someposer/mcp-omnifocus

使用说明

mcp全聚焦

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

特性

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

需求

安装

使用克隆存储库并安装依赖项 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"
                }
            }
        }
    }
}

许可证

麻省理工学院