Togello MCP Server exposes Togello tasks, categories, calendar memos, Google Calendar events, activity items, and activity logs through the Model Context Protocol.
- Node.js 22 or later
- A Togello API token
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 mode exposes an SSE endpoint at /sse and a message endpoint at /message.
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/sse
passthrough auth expects each remote client request to send its own Togello API token as an Authorization: Bearer ... header. 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.
Read-only tools include MCP readOnlyHint annotations and return stable JSON in both structuredContent and text content.
get-tasks-list: Retrieves incomplete TODO tasks. OptionalcategoryUUIDsfilters by category UUID.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-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.
create-task: Creates a TODO task.update-task: Updates a TODO task.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.
npm install
npm run buildCertified https://mcpreview.com/mcp-servers/toru-takagi/togello-mcp-server
npm run build
npm version patch
npm publish --access public