open-index/open-npm huggingface dataset:
npm package: @iflow-mcp/gong-api--subset-
Description: MCP Server generated from OpenAPI spec for gong-api--subset-
Latest version: 0.1.0

# Gong MCP

MCP integration for Gong API, enabling AI assistants to interact with Gong call recordings, transcripts, and analytics.

## Features

- Authentication via secure Basic Auth
- Access to calls, transcripts, users, and more
- Compatible with Cursor AI assistant
- Includes brief generation capability

## Prerequisites

- Node.js >= 20.0.0
- pnpm (recommended) or npm
- Gong API credentials (Access Key and Secret)

## Setup

1. Clone this repository
2. Install dependencies:
   ```bash
   pnpm install
   ```
3. Build the TypeScript code:
   ```bash
   pnpm build
   ```
4. Configure your global Cursor MCP config at `~/.cursor/mcp.json` with your Gong credentials:
   ```json
   {
     "mcpServers": {
       "gong-mcp": {
         "type": "stdio",
         "command": "/opt/homebrew/bin/node",
         "args": ["/path/to/gong-mcp/build/index.js"],
         "cwd": "/path/to/gong-mcp",
         "environment": {
           "GONG_ACCESS_KEY": "your-access-key",
           "GONG_SECRET": "your-secret"
         }
       }
     }
   }
   ```

## Environment Variables

The following environment variables are required:
- `GONG_ACCESS_KEY`: Your Gong API access key
- `GONG_SECRET`: Your Gong API secret

These can be set either in your environment or in the Cursor MCP config.

## Documentation

- [Main Documentation](docs/gong-mcp.md) - Detailed API and usage documentation
- [Sample Requests](docs/sample_requests.md) - Example API requests and responses

## Development

Available npm scripts:
```bash
pnpm build        # Build the TypeScript code
pnpm dev          # Watch mode for development
pnpm test         # Run all tests
pnpm test:smoke   # Run smoke tests only
pnpm lint         # Run ESLint
```

## Testing

Run the smoke tests to validate your setup:
```bash
pnpm test:smoke
```
Note: Make sure to have `GONG_ACCESS_KEY` and `GONG_SECRET` environment variables set before running tests.

## Usage with Cursor

Once configured in your global Cursor MCP settings, the AI assistant can:
- Retrieve call recordings and transcripts
- Search for calls by date range or participants
- Access user information
- Generate briefs for deals/accounts
- Analyze call patterns and metrics
npm package: @iflow-mcp/gong-mcp
Description: Gong MCP server implementation
Latest version: 0.1.0

# Gong MCP Server

A Model Context Protocol (MCP) server that provides access to Gong's API for retrieving call recordings and transcripts. This server allows Claude to interact with Gong data through a standardized interface.

## Features

- List Gong calls with optional date range filtering
- Retrieve detailed transcripts for specific calls
- Secure authentication using Gong's API credentials
- Standardized MCP interface for easy integration with Claude

## Prerequisites

- Node.js 18 or higher
- Docker (optional, for containerized deployment)
- Gong API credentials (Access Key and Secret)

## Installation

### Local Development

1. Clone the repository
2. Install dependencies:
   ```bash
   npm install
   ```
3. Build the project:
   ```bash
   npm run build
   ```

### Docker

Build the container:
```bash
docker build -t gong-mcp .
```

## Configuring Claude

1. Open Claude Desktop settings
2. Navigate to the MCP Servers section
3. Add a new server with the following configuration:

```json
{
  "command": "docker",
  "args": [
    "run",
    "-it",
    "--rm",
    "gong-mcp"
  ],
  "env": {
    "GONG_ACCESS_KEY": "your_access_key_here",
    "GONG_ACCESS_SECRET": "your_access_secret_here"
  }
}
```

4. Replace the placeholder credentials with your actual Gong API credentials from your `.env` file

## Available Tools

### List Calls

Retrieves a list of Gong calls with optional date range filtering.

```typescript
{
  name: "list_calls",
  description: "List Gong calls with optional date range filtering. Returns call details including ID, title, start/end times, participants, and duration.",
  inputSchema: {
    type: "object",
    properties: {
      fromDateTime: {
        type: "string",
        description: "Start date/time in ISO format (e.g. 2024-03-01T00:00:00Z)"
      },
      toDateTime: {
        type: "string",
        description: "End date/time in ISO format (e.g. 2024-03-31T23:59:59Z)"
      }
    }
  }
}
```

### Retrieve Transcripts

Retrieves detailed transcripts for specified call IDs.

```typescript
{
  name: "retrieve_transcripts",
  description: "Retrieve transcripts for specified call IDs. Returns detailed transcripts including speaker IDs, topics, and timestamped sentences.",
  inputSchema: {
    type: "object",
    properties: {
      callIds: {
        type: "array",
        items: { type: "string" },
        description: "Array of Gong call IDs to retrieve transcripts for"
      }
    },
    required: ["callIds"]
  }
}
```

## License

MIT License - see LICENSE file for details

## Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request