convez.ai
MCP ServerProdutividadeIntermediário
zcaceres

Google Tasks MCP Server

zcaceres/gtasks-mcp

Gerencie Google Tasks via Claude com search, create, update, delete

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra Google Tasks ao Claude, permitindo listar, buscar, criar, atualizar e deletar tarefas diretamente pela conversa. Funciona como uma extensão nativa que conecta sua produtividade no Google Tasks com os agentes Claude.

Instalação

$npx convez-ai zcaceres/gtasks-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
176
Forks
68
Acompanhando
2
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
24
Contribuidores
2

Casos de uso

  • Criar e atualizar tarefas durante brainstormings ou planejamento com Claude
  • Buscar tarefas existentes sem sair da conversa
  • Automatizar marcação de tarefas como completas via agentes Claude
  • Integrar fluxos de trabalho que envolvem gestão de tarefas com análise de IA

Veredito

Integração sólida e bem documentada para quem usa Google Tasks + Claude. A implementação via MCP é correta, suporta o ciclo completo CRUD e oferece autenticação OAuth segura. Recomendado para fluxos de produtividade que precisam conectar planejamento com assistência IA.

README

A tradução para o português deste README ainda está na fila.

Google Tasks MCP Server

gtasks mcp logo smithery badge

This MCP server integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.

Components

Tools

  • search

    • Search for tasks in Google Tasks
    • Input: query (string): Search query
    • Returns matching tasks with details
  • list

    • List all tasks in Google Tasks
    • Optional input: cursor (string): Cursor for pagination
    • Returns a list of all tasks
  • create

    • Create a new task in Google Tasks
    • Input:
      • taskListId (string, optional): Task list ID
      • title (string, required): Task title
      • notes (string, optional): Task notes
      • due (string, optional): Due date
    • Returns confirmation of task creation
  • update

    • Update an existing task in Google Tasks
    • Input:
      • taskListId (string, optional): Task list ID
      • id (string, required): Task ID
      • uri (string, required): Task URI
      • title (string, optional): New task title
      • notes (string, optional): New task notes
      • status (string, optional): New task status ("needsAction" or "completed")
      • due (string, optional): New due date
    • Returns confirmation of task update
  • delete

    • Delete a task in Google Tasks
    • Input:
      • taskListId (string, required): Task list ID
      • id (string, required): Task ID
    • Returns confirmation of task deletion
  • clear

    • Clear completed tasks from a Google Tasks task list
    • Input: taskListId (string, required): Task list ID
    • Returns confirmation of cleared tasks

Resources

The server provides access to Google Tasks resources:

  • Tasks (gtasks:///<task_id>)
    • Represents individual tasks in Google Tasks
    • Supports reading task details including title, status, due date, notes, and other metadata
    • Can be listed, read, created, updated, and deleted using the provided tools

Getting started

  1. Create a new Google Cloud project
  2. Enable the Google Tasks API
  3. Configure an OAuth consent screen ("internal" is fine for testing)
  4. Add scopes https://www.googleapis.com/auth/tasks
  5. Create an OAuth Client ID for application type "Desktop App"
  6. Download the JSON file of your client's OAuth keys
  7. Rename the key file to gcp-oauth.keys.json and place into the root of this repo (i.e. gcp-oauth.keys.json)

Make sure to build the server with either npm run build or npm run watch.

Installing via Smithery

To install Google Tasks Server for Claude Desktop automatically via Smithery:

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

Authentication

To authenticate and save credentials:

  1. Run the server with the auth argument: npm run start auth
  2. This will open an authentication flow in your system browser
  3. Complete the authentication process
  4. Credentials will be saved in the root of this repo (i.e. .gdrive-server-credentials.json)

Usage with Desktop App

To integrate this server with the desktop app, add the following to your app's server configuration:

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

Bom para

Relacionados