Google Tasks

Google Tasks MCP Server

Este servidor MCP integra-se ao Google Tasks para permitir listar, ler, pesquisar, criar, atualizar e excluir tarefas.

Componentes

Ferramentas

• search

  • Pesquisar tarefas no Google Tasks
  • Entrada: query (string): Consulta de pesquisa
  • Retorna tarefas correspondentes com detalhes

• list

  • Listar todas as tarefas no Google Tasks
  • Entrada opcional: cursor (string): Cursor para paginação
  • Retorna uma lista de todas as tarefas

• create

  • Criar uma nova tarefa no Google Tasks
  • Entrada:
    • taskListId (string, opcional): ID da lista de tarefas
    • title (string, obrigatório): Título da tarefa
    • notes (string, opcional): Notas da tarefa
    • due (string, opcional): Data de vencimento
  • Retorna confirmação da criação da tarefa

• update

  • Atualizar uma tarefa existente no Google Tasks
  • Entrada:
    • taskListId (string, opcional): ID da lista de tarefas
    • id (string, obrigatório): ID da tarefa
    • uri (string, obrigatório): URI da tarefa
    • title (string, opcional): Novo título da tarefa
    • notes (string, opcional): Novas notas da tarefa
    • status (string, opcional): Novo status da tarefa ("needsAction" ou "completed")
    • due (string, opcional): Nova data de vencimento
  • Retorna confirmação da atualização da tarefa

• delete

  • Excluir uma tarefa no Google Tasks
  • Entrada:
    • taskListId (string, obrigatório): ID da lista de tarefas
    • id (string, obrigatório): ID da tarefa
  • Retorna confirmação da exclusão da tarefa

• clear

  • Limpar tarefas concluídas de uma lista de tarefas do Google Tasks
  • Entrada: taskListId (string, obrigatório): ID da lista de tarefas
  • Retorna confirmação das tarefas limpas

Recursos

O servidor fornece acesso aos recursos do Google Tasks:

• Tasks (gtasks:///<task_id>)
  • Representa tarefas individuais no Google Tasks
  • Suporta leitura de detalhes da tarefa, incluindo título, status, data de vencimento, notas e outros metadados
  • Pode ser listado, lido, criado, atualizado e excluído usando as ferramentas fornecidas

Introdução

1. Criar um novo projeto do Google Cloud
2. Ativar a API Google Tasks
3. Configurar uma tela de consentimento OAuth ("internal" é suficiente para testes)
4. Adicionar escopos https://www.googleapis.com/auth/tasks
5. Criar um ID de cliente OAuth para o tipo de aplicativo "Desktop App"
6. Baixar o arquivo JSON das chaves OAuth do seu cliente
7. Renomear o arquivo de chave para gcp-oauth.keys.json e colocá-lo na raiz deste repositório (ou seja, gcp-oauth.keys.json)

Certifique-se de compilar o servidor com npm run build ou npm run watch.

Instalação via Smithery

Para instalar o Google Tasks Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

Autenticação

Para autenticar e salvar credenciais:

1. Execute o servidor com o argumento auth: npm run start auth
2. Isso abrirá um fluxo de autenticação no navegador do seu sistema
3. Conclua o processo de autenticação
4. As credenciais serão salvas na raiz deste repositório (ou seja, .gdrive-server-credentials.json)

Uso com o Aplicativo de Desktop

Para integrar este servidor ao aplicativo de desktop, adicione o seguinte à configuração do servidor do seu aplicativo:

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}