Cloudtasks MCP

🚀 Cloud Tasks MCP Service

A Model Context Protocol (MCP) server for interacting with Google Cloud Tasks, supporting operations on queues and tasks.

🚀 Quick Start

This is a Model Context Protocol (MCP) server designed to interact with Google Cloud Tasks, enabling operations on queues and tasks.

✨ Features

• List all Cloud Tasks queues under a specified location.
• Get detailed information about a specific queue.
• Pause and resume a queue.
• List tasks in a queue.
• Get detailed information about a specific task.
• Delete a task from a queue.

📦 Installation

Automatic Installation via Smithery

Automatically install the Cloud Tasks Server for Claude Desktop using 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 content to 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 list of location:project-id pairs in a comma-separated format, for example: us-east1:google-project-id1,us-central1:google-project-id2. The first listed project is the default project.

   The application expects to find the corresponding .json credential files for each project in the keys folder. Example path: keys/google-project-id1.json.

   Ensure that the relevant cloud service accounts have appropriate permissions to interact with Cloud Tasks, such as Cloud Tasks Admin or fewer permissions.

Available Tools

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

💻 Usage Examples (Claude Desktop)

Here are examples of using each tool in Claude Desktop:

Pause or Resume a Queue

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

Get the Number of Pending Tasks

How many tasks are waiting in the special-events queue?

Execute a Task in a Paused Queue

Execute the task ending with ID 123456 in the special events queue.

🔧 Technical Details

# Watch mode
npm run dev