{"id":30805531,"url":"https://github.com/aaronsb/gong-cloud","last_synced_at":"2025-10-11T04:20:03.949Z","repository":{"id":299912556,"uuid":"1004608419","full_name":"aaronsb/gong-cloud","owner":"aaronsb","description":"MCP server for Gong API integration, enabling AI agents to search calls, retrieve transcripts, and manage users with optimized token usage and speaker resolution.","archived":false,"fork":false,"pushed_at":"2025-06-18T23:03:08.000Z","size":56,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-06T00:58:48.203Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronsb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-18T22:40:42.000Z","updated_at":"2025-07-04T15:28:14.000Z","dependencies_parsed_at":"2025-06-19T00:18:41.447Z","dependency_job_id":"f7d4e50b-1f4a-470d-9146-f7884f230556","html_url":"https://github.com/aaronsb/gong-cloud","commit_stats":null,"previous_names":["aaronsb/gong-cloud"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aaronsb/gong-cloud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fgong-cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fgong-cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fgong-cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fgong-cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronsb","download_url":"https://codeload.github.com/aaronsb/gong-cloud/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fgong-cloud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006247,"owners_count":26084060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-06T00:58:45.814Z","updated_at":"2025-10-11T04:20:03.908Z","avatar_url":"https://github.com/aaronsb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gong Cloud MCP Server\n\nAn MCP (Model Context Protocol) server for interacting with the Gong API. This server enables AI agents to search Gong calls, retrieve transcripts, and find users with optimized token usage and contextual enrichment.\n\n## Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/gong-cloud.git\ncd gong-cloud\n\n# Install dependencies\nnpm install\n\n# Create .env file with your Gong API credentials\necho \"GONG_ACCESS_KEY=your_access_key\nGONG_ACCESS_KEY_SECRET=your_access_key_secret\nGONG_BASE_URL=https://your-domain.api.gong.io\" \u003e .env\n\n# Build the project\nnpm run build\n\n# Test the connection\nnpm run test:connection\n\n# Start the MCP server\nnpm run start\n```\n\nFor connecting to Claude Desktop and other LLMs, see the [LLMs Installation Guide](docs/llms-install.md).\n\n## Features\n\n- **List Calls**: Search for calls with optional date range filtering\n- **Get Call Details**: Retrieve detailed information about a specific call with its transcript\n- **Find Users**: Search for users by name, email, or ID\n- **Speaker Resolution**: Automatically resolves speaker IDs to actual names and roles\n- **Transcript Formatting**: Formats transcripts in a readable way with topics and speaker information\n- **Pagination Handling**: Automatically handles pagination for large result sets\n\n## Setup\n\n### Prerequisites\n\n- Node.js 18 or higher\n- Gong API access credentials\n\n### Installation\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/yourusername/gong-cloud.git\n   cd gong-cloud\n   ```\n\n2. Install dependencies:\n   ```\n   npm install\n   ```\n\n3. Create a `.env` file in the root directory with your Gong API credentials:\n   ```\n   GONG_ACCESS_KEY=your_access_key\n   GONG_ACCESS_KEY_SECRET=your_access_key_secret\n   GONG_BASE_URL=https://your-domain.api.gong.io\n   ```\n\n## Building and Running\n\n### Build the project\n\n```\nnpm run build\n```\n\n### Test API Connection\n\nBefore running the server, verify that your API credentials work:\n\n```\nnpm run test:connection\n```\n\nThis will list a few recent calls from your Gong account.\n\n### Find a User\n\nYou can search for users with:\n\n```\nnpm run test:find-user -- \"User Name\"\n```\n\nOr by email:\n\n```\nnpm run test:find-user -- \"\" \"user@example.com\"\n```\n\n### Get a Specific Call\n\nOnce you have a call ID, you can retrieve its details and transcript:\n\n```\nnpm run test:get-call -- \"call_id_here\"\n```\n\n### Start the MCP Server\n\n```\nnpm run start\n```\n\n## MCP Server Tools\n\nThe server provides the following tools:\n\n### `list_calls`\n\nLists Gong calls with optional date range filtering.\n\nParameters:\n- `fromDateTime` (optional): Start date/time in ISO format (e.g., \"2024-03-01T00:00:00Z\")\n- `toDateTime` (optional): End date/time in ISO format (e.g., \"2024-03-31T23:59:59Z\")\n- `limit` (optional): Maximum number of calls to return\n\n### `get_call_details`\n\nGets detailed information about a specific call, optionally including its transcript.\n\nParameters:\n- `callId` (required): ID of the call to retrieve\n- `includeTranscript` (optional): Whether to include the transcript in the response\n- `transcriptFormat` (optional): Format of the transcript (\"concise\", \"full\", or \"raw\")\n- `maxSegments` (optional): Maximum number of transcript segments to include (0 for all)\n- `maxSentences` (optional): Maximum number of sentences per segment (0 for all)\n\n### `find_users`\n\nSearches for users by name, email, or ID.\n\nParameters:\n- `name` (optional): Name to search for (can be partial)\n- `email` (optional): Email to search for (can be partial)\n- `id` (optional): Exact user ID to find\n\n## Development\n\n### Running in Development Mode\n\n```\nnpm run dev\n```\n\nThis will watch for changes and restart the server automatically.\n\n### Development Tools\n\n#### Gong API Inspector\n\nThe project uses a Gong API Inspector tool for exploring and understanding the Gong API specifications. This is particularly useful when implementing new features or debugging issues.\n\n**Location**: ../gong-api-inspector/\n\n**Usage**:\n```bash\n# Show general API information\npython3 ../gong-api-inspector/inspector.py --spec-file ../gong-api-inspector/gong-openapi.json --info\n\n# List all categories/tags\npython3 ../gong-api-inspector/inspector.py --spec-file ../gong-api-inspector/gong-openapi.json --list-groups\n\n# Show endpoints in a specific category\npython3 ../gong-api-inspector/inspector.py --spec-file ../gong-api-inspector/gong-openapi.json --category Calls\n```\n\n**Source**: https://github.com/aaronsb/gong-api-inspector\n\n### Linting\n\n```\nnpm run lint\n```\n\n### Formatting\n\n```\nnpm run format\n```\n\n## Project Structure\n\n- `/src`: Source code\n  - `/api`: API client for Gong API\n  - `/models`: Data models\n  - `/services`: Business logic\n  - `/utils`: Utility functions\n  - `index.ts`: Main entry point\n- `/scripts`: Test scripts\n- `/docs`: Documentation\n  - `llms-install.md`: Guide for setting up with Claude and other LLMs\n\n## Configuration for Claude Desktop\n\nTo use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"gong\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/gong-cloud/build/src/index.js\"],\n      \"env\": {\n        \"GONG_ACCESS_KEY\": \"your-access-key\",\n        \"GONG_ACCESS_KEY_SECRET\": \"your-access-key-secret\",\n        \"GONG_BASE_URL\": \"https://your-gong-api-url.gong.io\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": [\"list_calls\", \"find_users\", \"get_call_details\"]\n    }\n  }\n}\n```\n\nFor more detailed instructions, see the [LLMs Installation Guide](docs/llms-install.md).\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Acknowledgements\n\n- [Gong API](https://app.gong.io/settings/api)\n- [Model Context Protocol](https://github.com/ModelContextProtocol/mcp)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fgong-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronsb%2Fgong-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fgong-cloud/lists"}