Togello MCP Server

Togello MCP服务器

Togello MCP Server通过模型上下文协议公开Togello任务、类别、日历备忘录、Google日历事件、活动项和活动日志。

https://togello.com/sign

需求

• Node.js 22或更高版本
• Togello API代币

使用npm的本地MCP

将其用于通过stdio启动MCP服务器的桌面客户端和本地开发人员工具。

{
  "mcpServers": {
    "togello": {
      "command": "npx",
      "args": ["-y", "togello-mcp-server"],
      "env": {
        "TOGELLO_API_TOKEN": "replace_with_your_token"
      }
    }
  }
}

远程MCP

远程模式在以下位置公开了一个可流式传输的HTTP端点 /mcp。它还将传统SSE端点保持在 /sse 消息端点位于 /message 对于较旧的MCP客户端。

TOGELLO_MCP_MODE=remote \
TOGELLO_MCP_AUTH_MODE=passthrough \
TOGELLO_MCP_HOST=0.0.0.0 \
TOGELLO_MCP_PORT=8081 \
npm start

将远程MCP客户端连接到：

https://your-domain.example/mcp

passthrough auth期望每个远程客户端请求将其自己的Togello API令牌作为 Authorization: Bearer ... 头球将此模式用于已发布的远程MCP服务器。

env auth使用一个服务器端 TOGELLO_API_TOKEN 对于每个远程客户端。它仅适用于受信任的本地或单用户部署。当绑定到非本地主机时， TOGELLO_MCP_AUTH_MODE=env 还要求 TOGELLO_MCP_ALLOW_ENV_AUTH=true 因此，公共部署不能意外启用共享令牌身份验证。

ChatGPT开发人员模式可以添加使用SSE的远程MCP服务器。对于生产ChatGPT应用程序或连接器，请使用 passthrough auth或在将请求转发给Togello之前分别对每个用户进行身份验证的部署。

远程模式从以下位置提供OAuth授权服务器元数据 /.well-known/oauth-authorization-server 和 /.well-known/oauth-authorization-server/mcp 使用配置如下的Togello OAuth颁发者 TOGELLO_OAUTH_ISSUER 或 TOGELLO_API_BASE_URL.

连接到的远程OAuth客户端 /mcp 应在以下位置发现受保护的资源元数据 /.well-known/oauth-protected-resource/mcp。元数据返回 resource 作为完整的MCP端点URL，例如 https://your-domain.example/mcp.未经身份验证 /mcp 请求包括a WWW-Authenticate 挑战谁 resource_metadata 价值指向这一点 /mcp 元数据路径。

配置的OAuth颁发者必须是没有路径组件的源URL。

对于OpenAI Apps域验证，设置 TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN 验证令牌。然后，远程模式从 /.well-known/openai-apps-challenge 作为 text/plain如果两者都有 TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN 和 OPENAI_APPS_CHALLENGE_TOKEN 设置后，Togello作用域变量优先。

工具

只读工具包括MCP readOnlyHint 注释和返回稳定的JSON structuredContent 以及文本内容。

• get-tasks-list：检索不完整的TODO任务。可选的 categoryUUIDs 按类别UUID过滤。
• get-calendar-date-memo：检索日历日期备忘录 YYYY-MM-DD 日期。
• get-todo-category-list：检索TODO类别。
• get-today-calendar：检索链接的Google日历事件和计划任务。
• get-activity-item-list：检索已启用的活动项。
• get-activity-log-list：检索活动日志。
• get-japan-current-time：返回日本的当前时间。

编写工具返回JSON。失败的工具响应也返回JSON，并标记为 isError: true.

• create-task：创建TODO任务。
• update-task：更新TODO任务。
• update-calendar-date-memo：更新或清除日历日期备忘录。
• start-activity-log：启动活动日志。
• complete-activity-log：完成活动日志。

发展

npm install
npm run build

MCP审查

认证的 https://mcpreview.com/mcp-servers/toru-takagi/togello-mcp-server

发布

npm run build
npm version patch
npm publish --access public