Togello MCP Server
Togello MCP 服务器
Togello MCP 服务器通过模型上下文协议 (Model Context Protocol) 公开 Togello 任务、类别、日历备忘录、Google 日历事件、活动项和活动日志。
要求
Node.js 22 或更高版本
Togello API 令牌
Related MCP server: Todocko MCP Server
使用 npm 的本地 MCP
适用于通过 stdio 启动 MCP 服务器的桌面客户端和本地开发工具。
{
"mcpServers": {
"togello": {
"command": "npx",
"args": ["-y", "togello-mcp-server"],
"env": {
"TOGELLO_API_TOKEN": "replace_with_your_token"
}
}
}
}远程 MCP
远程模式在 /sse 公开 SSE 端点,并在 /message 公开消息端点。
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/ssepassthrough 身份验证要求每个远程客户端请求发送其自己的 Togello API 令牌作为 Authorization: Bearer ... 请求头。请将此模式用于已发布的远程 MCP 服务器。
env 身份验证为每个远程客户端使用一个服务器端的 TOGELLO_API_TOKEN。它仅适用于受信任的本地或单用户部署。当绑定到非本地主机时,TOGELLO_MCP_AUTH_MODE=env 还需要 TOGELLO_MCP_ALLOW_ENV_AUTH=true,以防止公共部署意外启用共享令牌身份验证。
ChatGPT 开发者模式可以添加使用 SSE 的远程 MCP 服务器。对于生产环境的 ChatGPT 应用或连接器,请使用 passthrough 身份验证,或在将请求转发给 Togello 之前分别对每个用户进行身份验证的部署方式。
工具
只读工具包含 MCP readOnlyHint 注释,并在 structuredContent 和文本内容中返回稳定的 JSON。
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 buildMCP 审查
已认证 https://mcpreview.com/mcp-servers/toru-takagi/togello-mcp-server
发布
npm run build
npm version patch
npm publish --access publicAvailable Tools
14 toolscomplete-activity-logCDestructive
Completes an activity log.
Inputs: activityLogUUID (required).
create-taskC
Creates a new task in the TODO feature.
Inputs: taskName (required), url, detail, status, +4 more.
delete-taskADestructiveIdempotent
Permanently deletes a single task from the TODO feature. Use only when the user requests deletion or removal. Specify the todoUUID obtained from get-tasks-list; clarify the target if ambiguous. To complete a task, use update-task with status DONE. To find completed tasks, call get-tasks-list with completionStatus COMPLETED. Repeated deletion succeeds when no task owned by the caller matches; success does not confirm that a task previously existed.
Inputs: todoUUID (required).
get-active-gathersARead-only
Retrieves active scheduling polls created or previously viewed by the authenticated user. Unconfirmed polls remain active until the adjustment end time; confirmed events and recruitments remain active until their start time, inclusive. Events that have already started are excluded.
Inputs: no named parameters.
get-activity-item-listCRead-only
Retrieves the list of activity items from the integration feature. Recognizes activity item UUID / item name
Inputs: no named parameters.
get-activity-log-listARead-only
Retrieves the list of activity logs from the integration feature. Since it is a record of what the person has done, if all the end dates are filled in, this person is not doing anything now. If there is one with a null end date, there should be at most one, and if there is one, it means that the person is doing it now. Recognizes activity log UUID / start date and time / end date and time / item name.
Inputs: limit.
get-calendar-date-memoBRead-only
Retrieves a calendar date memo for the specified date. Recognizes target date and memo content.
Inputs: date (required).
get-japan-current-timeARead-only
Returns the current time in Japan (JST).
Inputs: no named parameters.
get-tasks-listARead-only
Retrieves tasks from the TODO feature. By default it returns incomplete tasks. For tasks completed yesterday or during another period, set completionStatus to COMPLETED and pass completedStartDate and completedEndDate as RFC3339 date-times. Recognizes task uuid / task name / status / detail / completed date and time / scheduled start date and time / scheduled end date and time / deadline date and time / priority / category
Inputs: categoryUUIDs, completedEndDate, completionStatus, completedStartDate.
get-today-calendarARead-only
Retrieves scheduled events for yesterday/today/tomorrow from the linked Google Calendar. Recognizes event name / start date and time / end date and time.
Inputs: no named parameters.
get-todo-category-listBRead-only
Retrieves the list of categories from the TODO feature. Recognizes category name / category UUID
Inputs: no named parameters.
start-activity-logC
Starts an activity log.
Inputs: activityItemName (required).
update-calendar-date-memoCDestructive
Updates a calendar date memo for the specified date.
Inputs: date (required), memo (required).
update-taskCDestructive
Updates a task in the TODO feature.
Inputs: todoUUID (required), url, detail, status, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target a clearly distinct resource+action pair (task CRUD vs. calendar memo vs. activity log vs. scheduling polls). The only realistic confusion points are get-activity-item-list vs get-activity-log-list (same integration feature) and get-calendar-date-memo vs get-today-calendar (two different calendar sources), but descriptions give enough signal to separate them.
Every tool follows a uniform kebab-case verb_noun pattern: get-*, create-*, update-*, delete-*, start-*, complete-*. The verb prefix consistently indicates the operation class, so an agent can predict behavior from the name alone.
14 tools sit squarely in the well-scoped range and map onto five recognizable sub-domains (tasks, categories, calendar memo, Google Calendar, activity logs, polls). get-japan-current-time is a stray utility that could arguably be folded into other responses, but the set is not bloated.
Tasks have full CRUD, but several sibling domains are read-only or partial: calendar events can only be fetched (get-today-calendar) with no create/update, categories have no create/update, activity items are read-only, and activity logs have start/complete but no update/delete. Agents hitting these workflows will dead-end and must fall back to the external app.
Maintenance
Related MCP Connectors
Read and manage To-do Calendar todos, schedules and tags from an AI agent.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Start TODOs, send follow-ups and read agent results in your TODO for AI workspace.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides AI assistants with a standardized interface to interact with the Todo for AI task management system. It enables users to retrieve project tasks, create new entries, and submit completion feedback through natural language.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage Todocko application data, including tasks, projects, worklogs, and attachments. It supports comprehensive project management operations such as tracking activity, managing Kanban boards, and handling shared project synchronization.757 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Toggl time tracking API to manage time entries, projects, and workspaces through natural language.22MIT
- FlicenseCqualityDmaintenanceEnables managing todo lists and tasks through natural language, supporting creation, status changes, and deletion.7-