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.

https://togello.com/sign

Requirements

• Node.js 22 or later
• A Togello API token

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 start

Connect remote MCP clients to:

https://your-domain.example/mcp

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.

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. Optional categoryUUIDs filters by category UUID. Use completionStatus: "COMPLETED" with both completedStartDate and completedEndDate in RFC3339 format to retrieve tasks completed during a period.
• get-calendar-date-memo: Retrieves a calendar date memo for a YYYY-MM-DD date.
• 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. 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.
• 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 install
npm run build

MCP Review

Certified https://mcpreview.com/mcp-servers/toru-takagi/togello-mcp-server

Publish

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