{"_id":"@arvoretech/google-chat-mcp","_rev":"6-35836432da1bc22c61940132a09fcb11","name":"@arvoretech/google-chat-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@arvoretech/google-chat-mcp","version":"1.0.0","keywords":["mcp","google-chat","google-workspace","chat","llm","ai","arvore"],"author":{"name":"Arvore"},"license":"MIT","_id":"@arvoretech/google-chat-mcp@1.0.0","maintainers":[{"name":"joao.barros.arvore","email":"joao.barros@arvore.com.br"}],"homepage":"https://github.com/arvoreeducacao/arvore-mcp-servers#readme","bugs":{"url":"https://github.com/arvoreeducacao/arvore-mcp-servers/issues"},"bin":{"google-chat-mcp":"dist/index.js"},"dist":{"shasum":"49d4e2080333dab0371e0d3e8cf8983393532962","tarball":"https://registry.npmjs.org/@arvoretech/google-chat-mcp/-/google-chat-mcp-1.0.0.tgz","fileCount":21,"integrity":"sha512-lmIkhLx6LmXwM4+WPs26ietstGuhAcPFpamo/Ejk64nMG2b4btApDDOgyTgDFEFF6ZwUxvH0fBMVTYeGSOATdA==","signatures":[{"sig":"MEUCIQCfbqoozzHctwmhDBp+kbuvkffnwNnAImTNJN4kOuk2PwIgX/tdVJpMop200cjNXBb2XZULlLEb5X61kaDnledlXRU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95688},"main":"dist/index.js","type":"module","gitHead":"6f6caf646b25492c6f29eeda301eaed2b542fa0d","scripts":{"dev":"tsx src/index.ts","lint":"eslint src/**/*.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","lint:fix":"eslint src/**/*.ts --fix","test:cov":"vitest run --coverage"},"_npmUser":{"name":"joao.barros.arvore","email":"joao.barros@arvore.com.br"},"repository":{"url":"git+https://github.com/arvoreeducacao/arvore-mcp-servers.git","type":"git","directory":"packages/google-chat"},"_npmVersion":"10.8.2","description":"Google Chat MCP Server for managing spaces, members, and messages via Google Chat API","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/google-chat-mcp_1.0.0_1771528446898_0.3839658730455813","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-02-19T19:14:06.826Z","modified":"2026-06-16T21:13:12.074Z","1.0.0":"2026-02-19T19:14:07.039Z"},"bugs":{"url":"https://github.com/arvoreeducacao/arvore-mcp-servers/issues"},"author":{"name":"Arvore"},"license":"MIT","homepage":"https://github.com/arvoreeducacao/arvore-mcp-servers#readme","keywords":["mcp","google-chat","google-workspace","chat","llm","ai","arvore"],"repository":{"url":"git+https://github.com/arvoreeducacao/arvore-mcp-servers.git","type":"git","directory":"packages/google-chat"},"description":"Google Chat MCP Server for managing spaces, members, and messages via Google Chat API","maintainers":[{"email":"joao.barros@arvore.com.br","name":"joao.barros.arvore"},{"email":"rafasouza@protonmail.com","name":"rafsouza"},{"email":"pedro.adas@gmail.com","name":"pedro.adas"},{"email":"guilhermebscontact@gmail.com","name":"guilhermebs"},{"email":"ricardorbxx1@gmail.com","name":"ricardoraposorfox"},{"email":"jvgcunha2002@gmail.com","name":"jott4"},{"email":"vitor.piovezan@arvore.com.br","name":"vitor.piovezan"}],"readme":"# @arvoretech/google-chat-mcp\n\nMCP server for Google Chat — manage spaces, members, and messages from your AI assistant.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `spaces_list` | List Google Chat spaces |\n| `spaces_get` | Get space details |\n| `members_list` | List space members |\n| `messages_list` | List messages with filtering and pagination |\n| `messages_get` | Get a specific message |\n| `messages_create` | Send a message (supports threads) |\n| `messages_delete` | Delete a message |\n\n## Authentication\n\nUses Google Service Account with JWT-based auth (no external dependencies — built on `node:crypto`).\n\n**Two modes:**\n\n- **Bot mode** (default): Uses `chat.bot` scope. Access limited to spaces where the bot is added.\n- **User mode**: Uses domain-wide delegation to impersonate a user. Full access to spaces, members, and messages.\n\n### Setup\n\n1. Create a service account in [Google Cloud Console](https://console.cloud.google.com/iam-admin/serviceaccounts)\n2. Enable the [Google Chat API](https://console.cloud.google.com/apis/library/chat.googleapis.com)\n3. Download the service account JSON key\n4. (For user mode) Enable [domain-wide delegation](https://developers.google.com/workspace/guides/create-credentials#optional_set_up_domain-wide_delegation_for_a_service_account) and add the required scopes in the Google Workspace Admin Console\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `GOOGLE_CHAT_CREDENTIALS_PATH` | Yes* | Path to service account JSON key file |\n| `GOOGLE_CHAT_CREDENTIALS_JSON` | Yes* | Service account JSON as string (alternative to PATH) |\n| `GOOGLE_CHAT_USER_EMAIL` | No | Email to impersonate via domain-wide delegation (enables user mode) |\n| `GOOGLE_CHAT_SCOPES` | No | Comma-separated OAuth scopes (auto-detected based on mode) |\n\n\\* One of `GOOGLE_CHAT_CREDENTIALS_PATH` or `GOOGLE_CHAT_CREDENTIALS_JSON` is required. `GOOGLE_APPLICATION_CREDENTIALS` is also accepted as a fallback for PATH.\n\n### Default Scopes\n\n**Bot mode** (no `GOOGLE_CHAT_USER_EMAIL`):\n- `https://www.googleapis.com/auth/chat.bot`\n\n**User mode** (with `GOOGLE_CHAT_USER_EMAIL`):\n- `https://www.googleapis.com/auth/chat.spaces.readonly`\n- `https://www.googleapis.com/auth/chat.messages`\n- `https://www.googleapis.com/auth/chat.memberships.readonly`\n\n## Configuration\n\n### Claude Desktop / Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"google-chat\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@arvoretech/google-chat-mcp\"],\n      \"env\": {\n        \"GOOGLE_CHAT_CREDENTIALS_PATH\": \"/path/to/service-account.json\",\n        \"GOOGLE_CHAT_USER_EMAIL\": \"user@yourdomain.com\"\n      }\n    }\n  }\n}\n```\n\n### Bot mode (no impersonation)\n\n```json\n{\n  \"mcpServers\": {\n    \"google-chat\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@arvoretech/google-chat-mcp\"],\n      \"env\": {\n        \"GOOGLE_CHAT_CREDENTIALS_PATH\": \"/path/to/service-account.json\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\n```bash\npnpm install\npnpm dev      # Run in dev mode\npnpm build    # Compile TypeScript\npnpm test     # Run tests\npnpm lint     # Lint\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}