Togello MCP Server

Um servidor MCP para gerenciar contexto de aplicações usando a API Togello.

GitHub

Documentação

Servidor MCP Togello

O Servidor MCP Togello expõe tarefas, categorias, lembretes de calendário, eventos do Google Calendar, itens de atividade e registros de atividade do Togello por meio do Model Context Protocol.

https://togello.com/sign

Requisitos

  • Node.js 22 ou posterior
  • Um token de API do Togello

Compatibilidade de protocolo

O servidor usa o MCP TypeScript SDK v2. Stdio e /mcp suportam o protocolo MCP 2026-07-28 e clientes legados que usam o handshake initialize. O endpoint /mcp mantém sessões para clientes legados; solicitações modernas são stateless. /sse e /message permanecem disponíveis para clientes legados.

Solicitações remotas modernas devem incluir um cabeçalho Authorization: Bearer ... em cada solicitação. Suas credenciais são isoladas por solicitação, inclusive quando um ID de sessão legado é fornecido. Conexões legadas mantêm o token fornecido quando sua sessão foi criada. As URLs de metadados OAuth existentes e os modos de autenticação permanecem inalterados.

MCP Events não são implementados.

MCP Local com npm

Use isto para clientes desktop e ferramentas de desenvolvimento locais que iniciam servidores MCP via stdio.

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

MCP Remoto

O modo remoto expõe um endpoint HTTP Streamable em /mcp. Ele também mantém o endpoint SSE legado em /sse e o endpoint de mensagens em /message para clientes MCP mais antigos.

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

A autenticação passthrough usa o token de API do Togello do usuário conectado, obtido do cabeçalho Authorization: Bearer .... Solicitações modernas exigem este cabeçalho em cada solicitação; sessões legadas mantêm o token da conexão. Use este modo para servidores MCP remotos publicados.

A autenticação env usa um TOGELLO_API_TOKEN do lado do servidor para cada cliente remoto. Destina-se apenas a implantações locais confiáveis ou de usuário único. Ao vincular a um host não local, TOGELLO_MCP_AUTH_MODE=env também exige TOGELLO_MCP_ALLOW_ENV_AUTH=true para que implantações públicas não possam habilitar autenticação por token compartilhado acidentalmente.

O modo desenvolvedor do ChatGPT pode adicionar servidores MCP remotos que usam SSE. Para aplicativos ou conectores ChatGPT de produção, use autenticação passthrough ou uma implantação que autentique cada usuário separadamente antes de encaminhar solicitações ao Togello.

O modo remoto serve metadados do servidor de autorização OAuth de /.well-known/oauth-authorization-server e /.well-known/oauth-authorization-server/mcp usando o emissor OAuth do Togello configurado com TOGELLO_OAUTH_ISSUER ou TOGELLO_API_BASE_URL.

Clientes OAuth remotos que se conectam a /mcp devem descobrir metadados de recurso protegido em /.well-known/oauth-protected-resource/mcp. Esses metadados retornam resource como a URL completa do endpoint MCP, como https://your-domain.example/mcp. Solicitações /mcp não autenticadas incluem um desafio WWW-Authenticate cujo valor resource_metadata aponta para esse caminho de metadados /mcp.

O emissor OAuth configurado deve ser uma URL de origem sem componente de caminho.

Para verificação de domínio de OpenAI Apps, defina TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN como o token de verificação. O modo remoto então o serve de /.well-known/openai-apps-challenge como text/plain. Se ambos TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKEN e OPENAI_APPS_CHALLENGE_TOKEN estiverem definidos, a variável com escopo Togello tem precedência.

Ferramentas

Todas as ferramentas definem anotações MCP readOnlyHint, openWorldHint e destructiveHint explicitamente. Ferramentas somente leitura retornam JSON estável tanto em structuredContent quanto em conteúdo de texto.

  • get-tasks-list: Recupera tarefas TODO. Por padrão, recupera tarefas incompletas. O categoryUUIDs opcional filtra por UUID de categoria. Use completionStatus: "COMPLETED" com ambos completedStartDate e completedEndDate no formato RFC3339 para recuperar tarefas concluídas durante um período.
  • get-calendar-date-memo: Recupera um lembrete de data de calendário para uma data YYYY-MM-DD.
  • get-todo-category-list: Recupera categorias TODO.
  • get-today-calendar: Recupera eventos vinculados do Google Calendar e tarefas agendadas.
  • get-activity-item-list: Recupera itens de atividade habilitados.
  • get-activity-log-list: Recupera registros de atividade.
  • get-japan-current-time: Retorna a hora atual no Japão.

Ferramentas de escrita retornam JSON. Respostas de ferramentas com falha também retornam JSON e são marcadas com isError: true. Ferramentas que podem sobrescrever dados privados existentes do Togello definem destructiveHint: true; ferramentas de criação/início definem destructiveHint: false.

  • create-task: Cria uma tarefa TODO.
  • update-task: Atualiza uma tarefa TODO, incluindo atribuição ou remoção de categoria.
  • update-calendar-date-memo: Atualiza ou limpa um lembrete de data de calendário.
  • start-activity-log: Inicia um registro de atividade.
  • complete-activity-log: Conclui um registro de atividade.

Desenvolvimento

npm ci
npm test

Os testes de protocolo exercitam clientes modernos SDK v2 e clientes legados SDK v1.29.0 via stdio, Streamable HTTP e SSE legado contra uma API simulada local. Eles verificam os 12 contratos de ferramentas existentes, resultados de leitura/escrita, isolamento de credenciais de solicitação, erros de cabeçalho de protocolo, limites de corpo, metadados e ciclo de vida de sessão legado. test/fixtures/v1-tools.json registra tools/list do servidor 1.0.42 no commit 558c2c2fda81f7c8b20f443afa1bf5e554a72dad; comparações permitem o dialeto de esquema JSON Schema do SDK e mudanças de formato de transmissão.

Esquemas voltados ao SDK usam Zod 4. Campos UUID mantêm a sintaxe UUID permissiva anterior, e campos de data-hora mantêm sua validação Zod 3 anterior por meio da exportação de compatibilidade incluída no pacote Zod.

Revisão MCP

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

Publicação

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