Togello MCP Server

Un servidor MCP para gestionar el contexto de aplicaciones mediante la API de Togello.

GitHub

Documentación

Servidor MCP de Togello

El Servidor MCP de Togello expone tareas, categorías, memos de calendario, eventos de Google Calendar, elementos de actividad y registros de actividad de Togello a través del Protocolo de Contexto de Modelo.

https://togello.com/sign

Requisitos

  • Node.js 22 o posterior
  • Un token de API de Togello

Compatibilidad de protocolo

El servidor utiliza el SDK de TypeScript de MCP v2. Stdio y /mcp admiten el protocolo MCP 2026-07-28 y clientes heredados que utilizan el protocolo de enlace initialize. El endpoint /mcp conserva sesiones para clientes heredados; las solicitudes modernas no tienen estado. /sse y /message permanecen disponibles para clientes heredados.

Las solicitudes remotas modernas deben incluir cada una un encabezado Authorization: Bearer .... Sus credenciales están aisladas por solicitud, incluso cuando se proporciona un ID de sesión heredado. Las conexiones heredadas conservan el token proporcionado cuando se creó su sesión. Las URL de metadatos de OAuth existentes y los modos de autenticación no cambian.

Los Eventos de MCP no están implementados.

MCP Local con npm

Use esto para clientes de escritorio y herramientas de desarrollo locales que inician servidores MCP a través de stdio.

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

MCP Remoto

El modo remoto expone un endpoint HTTP Streamable en /mcp. También mantiene el endpoint SSE heredado en /sse y el endpoint de mensajes en /message para clientes MCP más antiguos.

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

Conecte clientes MCP remotos a:

https://your-domain.example/mcp

La autenticación passthrough utiliza el token de API de Togello del usuario que se conecta desde el encabezado Authorization: Bearer .... Las solicitudes modernas requieren este encabezado en cada solicitud; las sesiones heredadas conservan el token de la conexión. Use este modo para servidores MCP remotos publicados.

La autenticación env utiliza un TOGELLO_API_TOKEN del lado del servidor para cada cliente remoto. Está destinada únicamente a implementaciones locales confiables o de un solo usuario. Al vincularse a un host no local, TOGELLO_MCP_AUTH_MODE=env también requiere TOGELLO_MCP_ALLOW_ENV_AUTH=true para que las implementaciones públicas no puedan habilitar la autenticación de token compartido por accidente.

El modo de desarrollador de ChatGPT puede agregar servidores MCP remotos que usen SSE. Para aplicaciones o conectores de ChatGPT en producción, use la autenticación passthrough o una implementación que autentique a cada usuario por separado antes de reenviar solicitudes a Togello.

El modo remoto sirve metadatos del servidor de autorización OAuth desde /.well-known/oauth-authorization-server y /.well-known/oauth-authorization-server/mcp utilizando el emisor OAuth de Togello configurado con TOGELLO_OAUTH_ISSUER o TOGELLO_API_BASE_URL.

Los clientes OAuth remotos que se conecten a /mcp deben descubrir los metadatos del recurso protegido en /.well-known/oauth-protected-resource/mcp. Esos metadatos devuelven resource como la URL completa del endpoint MCP, como https://your-domain.example/mcp. Las solicitudes /mcp no autenticadas incluyen un desafío WWW-Authenticate cuyo valor resource_metadata apunta a esa ruta de metadatos /mcp.

El emisor OAuth configurado debe ser una URL de origen sin componente de ruta.

Para la verificación de dominio de OpenAI Apps, establezca TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN al token de verificación. El modo remoto lo sirve desde /.well-known/openai-apps-challenge como text/plain. Si tanto TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN como OPENAI_APPS_CHALLENGE_TOKEN están configurados, la variable con ámbito de Togello tiene prioridad.

Herramientas

Todas las herramientas establecen anotaciones MCP readOnlyHint, openWorldHint y destructiveHint explícitamente. Las herramientas de solo lectura devuelven JSON estable tanto en structuredContent como en contenido de texto.

  • get-tasks-list: Recupera tareas TODO. De forma predeterminada, recupera tareas incompletas. El categoryUUIDs opcional filtra por UUID de categoría. Use completionStatus: "COMPLETED" con tanto completedStartDate como completedEndDate en formato RFC3339 para recuperar tareas completadas durante un período.
  • get-calendar-date-memo: Recupera un memo de fecha de calendario para una fecha YYYY-MM-DD.
  • get-todo-category-list: Recupera categorías TODO.
  • get-today-calendar: Recupera eventos de Google Calendar vinculados y tareas programadas.
  • get-activity-item-list: Recupera elementos de actividad habilitados.
  • get-activity-log-list: Recupera registros de actividad.
  • get-japan-current-time: Devuelve la hora actual en Japón.

Las herramientas de escritura devuelven JSON. Las respuestas de herramientas fallidas también devuelven JSON y están marcadas con isError: true. Las herramientas que pueden sobrescribir datos privados existentes de Togello establecen destructiveHint: true; las herramientas de creación/inicio establecen destructiveHint: false.

  • create-task: Crea una tarea TODO.
  • update-task: Actualiza una tarea TODO, incluida la asignación o eliminación de categoría.
  • update-calendar-date-memo: Actualiza o borra un memo de fecha de calendario.
  • start-activity-log: Inicia un registro de actividad.
  • complete-activity-log: Completa un registro de actividad.

Desarrollo

npm ci
npm test

Las pruebas de protocolo ejercitan clientes modernos del SDK v2 y clientes heredados del SDK v1.29.0 a través de stdio, HTTP Streamable y SSE heredado contra una API simulada local. Verifican los 12 contratos de herramientas existentes, resultados de lectura/escritura, aislamiento de credenciales de solicitud, errores de encabezado de protocolo, límites de cuerpo, metadatos y ciclo de vida de sesión heredado. test/fixtures/v1-tools.json registra tools/list del servidor 1.0.42 en el commit 558c2c2fda81f7c8b20f443afa1bf5e554a72dad; las comparaciones permiten el dialecto de esquema JSON del SDK y los cambios de formato de cable.

Los esquemas orientados al SDK usan Zod 4. Los campos UUID conservan la sintaxis UUID permisiva anterior, y los campos de fecha y hora conservan su validación anterior de Zod 3 a través de la exportación de compatibilidad incluida en el paquete Zod.

Revisión de MCP

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

Publicar

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