@ndev-hoster/chat-mcp
v1.0.3
Published
Standalone MCP Server for Google Workspace Chat API v1 (agy-mcps)
Readme
Google Chat MCP Server (@ndev-hoster/chat-mcp)
Model Context Protocol (MCP) server managing spaces, direct messages, and chat threads through Google Chat API v1.
Works across macOS, Linux, and Windows.
Exposed Tools
| Tool Name | Description | Key Parameters |
|---|---|---|
| list_spaces | Enumerate all Google Chat rooms and group conversations accessible to the user. | pageSize (number, default: 20) |
| get_space | Fetch detailed metadata for a specific chat space. | spaceName (string, required) |
| list_messages | List recent messages in a chat space. | spaceName (string, required), pageSize (number, default: 25) |
| get_message / read_message | Retrieve full message content, cards, and author details by message name. | messageName (string, required) |
| send_message | Post a new message or card to a space or reply within a thread. | spaceName (string, required), text (string, required), threadKey (string) |
| search_messages / search_conversations | Search across messages in Google Chat using keyword filters. | query (string, required), pageSize (number, default: 20) |
| list_memberships | Enumerate human and bot members inside a Google Chat space. | spaceName (string, required), pageSize (number) |
Quick Start
1. Prerequisites & Credentials
Follow the Google Cloud Project & OAuth Setup Guide to download your credentials.json and place it in:
- macOS / Linux:
~/.config/agy-mcps/credentials.json - Windows:
%USERPROFILE%\.config\agy-mcps\credentials.json
2. Authenticate (One-Time)
npx -y @ndev-hoster/chat-mcp --auth3. Client Configuration (mcp_config.json)
"chat": {
"command": "npx",
"args": ["-y", "@ndev-hoster/chat-mcp"]
}Local Development
npm install
npm run build
npm run test:verify