Togello MCP Server
Integrates with Google Calendar to retrieve yesterday's, today's, and tomorrow's calendar events including event names, start times, and end times.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Togello MCP Server show me my incomplete tasks for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Togello MCP Server
Togello MCP Server exposes Togello tasks, categories, calendar memos, Google Calendar events, activity items, and activity logs through the Model Context Protocol.
Requirements
Node.js 24.22.1 or later
A Togello API token
Related MCP server: Todocko MCP Server
Protocol compatibility
The server uses MCP TypeScript SDK v2. Stdio and /mcp support the MCP 2026-07-28 protocol and legacy clients using the initialize handshake. The /mcp endpoint retains sessions for legacy clients; modern requests are stateless. /sse and /message remain available for legacy clients.
Modern remote requests must each include an Authorization: Bearer ... header. Their credentials are isolated per request, including when a legacy session ID is supplied. Legacy connections retain the token provided when their session was created. The existing OAuth metadata URLs and authentication modes are unchanged.
MCP Events are not implemented.
Local MCP With npm
Use this for desktop clients and local developer tools that launch MCP servers over stdio.
{
"mcpServers": {
"togello": {
"command": "npx",
"args": ["-y", "togello-mcp-server"],
"env": {
"TOGELLO_API_TOKEN": "replace_with_your_token"
}
}
}
}Remote MCP
Remote mode exposes a Streamable HTTP endpoint at /mcp. It also keeps the legacy SSE endpoint at /sse and message endpoint at /message for older MCP clients.
TOGELLO_MCP_MODE=remote \
TOGELLO_MCP_AUTH_MODE=passthrough \
TOGELLO_MCP_HOST=0.0.0.0 \
TOGELLO_MCP_PORT=8081 \
npm startConnect remote MCP clients to:
https://your-domain.example/mcppassthrough auth uses the connecting user's Togello API token from the Authorization: Bearer ... header. Modern requests require this header on every request; legacy sessions retain the connection's token. Use this mode for published remote MCP servers.
env auth uses one server-side TOGELLO_API_TOKEN for every remote client. It is intended only for trusted local or single-user deployments. When binding to a non-local host, TOGELLO_MCP_AUTH_MODE=env also requires TOGELLO_MCP_ALLOW_ENV_AUTH=true so public deployments cannot enable shared-token auth by accident.
ChatGPT developer mode can add remote MCP servers that use SSE. For production ChatGPT apps or connectors, use passthrough auth or a deployment that authenticates each user separately before forwarding requests to Togello.
Remote mode serves OAuth authorization server metadata from /.well-known/oauth-authorization-server and /.well-known/oauth-authorization-server/mcp using the Togello OAuth issuer configured with TOGELLO_OAUTH_ISSUER or TOGELLO_API_BASE_URL.
Remote OAuth clients that connect to /mcp should discover protected resource metadata at /.well-known/oauth-protected-resource/mcp. That metadata returns resource as the full MCP endpoint URL, such as https://your-domain.example/mcp. Unauthenticated /mcp requests include a WWW-Authenticate challenge whose resource_metadata value points to that /mcp metadata path.
The configured OAuth issuer must be an origin URL without a path component.
For OpenAI Apps domain verification, set TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN to the verification token. Remote mode then serves it from /.well-known/openai-apps-challenge as text/plain. If both TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN and OPENAI_APPS_CHALLENGE_TOKEN are set, the Togello-scoped variable takes precedence.
Tools
All tools set MCP readOnlyHint, openWorldHint, and destructiveHint annotations explicitly. Read-only tools return stable JSON in both structuredContent and text content.
get-tasks-list: Retrieves TODO tasks. By default it retrieves incomplete tasks. OptionalcategoryUUIDsfilters by category UUID. UsecompletionStatus: "COMPLETED"with bothcompletedStartDateandcompletedEndDatein RFC3339 format to retrieve tasks completed during a period.get-calendar-date-memo: Retrieves a calendar date memo for aYYYY-MM-DDdate.get-todo-category-list: Retrieves TODO categories.get-today-calendar: Retrieves linked Google Calendar events and scheduled tasks.get-activity-item-list: Retrieves enabled activity items.get-activity-log-list: Retrieves activity logs.get-active-gathers: Retrieves active scheduling polls created or previously viewed by the authenticated user, usingGET /v2/gathers. Takes no arguments. Unconfirmed polls are active through their adjustment end time; confirmed events and recruitments are active through their start time, inclusive. Already-started events are excluded even if they have not ended. Missing or invalid eligibility dates are excluded. Results retain API ordering and contain only UUID, title, mode, adjustment and confirmed timestamps, participant counts, and relationship type. Returns{ "gathers": [] }when none qualify; API failures are errors.get-japan-current-time: Returns the current time in Japan.
Write tools return JSON. Failed tool responses also return JSON and are marked with isError: true. Tools that can overwrite existing private Togello data set destructiveHint: true; create/start tools set destructiveHint: false.
create-task: Creates a TODO task.update-task: Updates a TODO task, including category assignment or removal.delete-task: Permanently deletes one TODO task bytodoUUIDfromget-tasks-list. Useupdate-taskwithstatus: "DONE"to complete a task. To find completed tasks for deletion, usecompletionStatus: "COMPLETED". This destructive, idempotent tool returns{ "todoUUID": "...", "deleted": true }after a successful API response, including when no task owned by the caller matches. Success does not prove that a task previously existed. Ambiguous targets must be clarified before deletion.update-calendar-date-memo: Updates or clears a calendar date memo.start-activity-log: Starts an activity log.complete-activity-log: Completes an activity log.
Development
npm ci
npm testThe protocol tests exercise SDK v2 modern clients and SDK v1.32.2 legacy clients over stdio, Streamable HTTP, and legacy SSE against a local mock API. They verify the 12 existing tool contracts and the added deletion and active scheduling poll tools, read/write/delete results, request credential isolation, protocol header errors, body limits, metadata, and legacy session lifecycle. test/fixtures/v1-tools.json records tools/list from server 1.0.42 at commit 558c2c2fda81f7c8b20f443afa1bf5e554a72dad; comparisons allow the SDK's JSON Schema dialect and wire-format changes.
SDK-facing schemas use Zod 4. UUID fields retain the prior permissive UUID syntax, and date-time fields retain their previous Zod 3 validation through the compatibility export included in the Zod package.
MCP Review
Certified https://mcpreview.com/mcp-servers/toru-takagi/togello-mcp-server
Publish
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.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
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.58 npmApache 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.1MIT
- 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-