cloudtasks mcp

A Model Context Protocol (MCP) server for Google Cloud Tasks that enables interactions with Google Cloud Tasks queues and tasks.

Features

• List Cloud Tasks queues in a specified location
• Get details of a specific queue
• Pause and resume queues
• List tasks in a queue
• Get details of a specific task
• Delete tasks from a queue

Setup

Installing via Smithery

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

npx -y @smithery/cli install @gitskyflux/cloudtasks-mcp --client claude

Manual Installation

1. Install dependencies:

   npm install

2. Build the project:

   npm run build

3. Configure Claude Desktop: Add the following to your claude_desktop_config.json:

"cloudtasks-mcp": {
  "command": "node",
  "args": [
    "/path/to/cloudtasks-mcp/build/index.js"
  ],
  "env": {
    "GOOGLE_CLOUD_LOCATION_PROJECTS": "location:project-id"
  }
}

Replace the path in args with the actual path to index.js.

Define a comma-separated list of location:project-id pairs in GOOGLE_CLOUD_LOCATION_PROJECTS. Example: us-east1:google-project-id1,us-central1:google-project-id2 The first listed project is the default.

The application expects to find .json credential file(s) in the keys folder for each project. Example: keys/google-project-id1.json

Ensure the relevant cloud service account has appropriate permission to interact with Cloud Tasks, e.g. Cloud Tasks Admin or lesser permission(s).

Available Tools

• listQueues: List all Cloud Tasks queues in a specified location
• getQueue: Get details of a specific Cloud Tasks queue
• pauseQueue: Pause a Cloud Tasks queue
• resumeQueue: Resume a paused Cloud Tasks queue
• listTasks: List tasks in a Cloud Tasks queue
• getTask: Get details of a specific task in a Cloud Tasks queue
• deleteTask: Delete a task from a Cloud Tasks queue

Example Usage in Claude Desktop

Here are examples of how to use each tool in Claude Desktop:

Pause or Resume a Queue

Pause the special-events queue. Resume the special-events queue.

Get Pending Tasks

How many tasks are currently pending in the special-events queue?

Run a Task in a Paused Queue

Run the task ending with the ID 123456 in the special-events queue.

Development

# Watch mode
npm run dev