gchat-mcp

# gchat-mcp MCP (Model Context Protocol) server for Google Chat integration. This server provides tools to interact with Google Chat spaces and messages. ## Features - List all Google Chat spaces you're a member of - Retrieve recent messages from any space - Search messages by text content ## Installation ### Using uv ```bash # Create virtual environment uv venv # Activate it source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies uv pip install -e ".[dev]" ``` ### Or with pip ```bash pip install -e ".[dev]" ``` ## Setup 1. **Create a Google Cloud project**: [https://console.cloud.google.com/](https://console.cloud.google.com/) 2. **Enable Google Chat API**: ```bash gcloud services enable chat.googleapis.com ``` 3. **Create a service account**: - Go to IAM & Admin > Service Accounts - Click "Create Service Account" - Give it a name (e.g., "gchat-mcp") - Click "Generate Key" and select JSON format - Download the JSON file 4. **Place credentials**: Put your service account JSON as `credentials.json` in the project root 5. **Validate credentials**: ```bash make oauth # or uv run python oauth_setup.py credentials.json ``` ## Usage ### As an MCP Server ```bash # Start the MCP server uv run python -m src.apps.gchat_mcp.server ``` ### Available Tools #### `list_spaces()` Returns a list of Google Chat spaces the authenticated user is a member of. **Example:** ```python from src.apps.gchat_mcp.server import app # In MCP context spaces = await app.call_tool("list_spaces") print(spaces) # [{'spaceId': 'abc123', 'name': 'General', 'iconLink': 'https://...'}] ``` #### `list_messages(space_id, limit=20)` Retrieves recent messages from a specific space. **Arguments:** - `space_id` (str): The unique identifier of the space - `limit` (int, optional): Maximum number of messages to retrieve (default: 20) **Example:** ```python messages = await app.call_tool("list_messages",…