# Official MCP Server for MeetGeek API

🚀 **Self-hosted open source MeetGeek MCP**

This open source MCP implementation lets AI tools such as Claude or Cursor access your MeetGeek meetings. Get meeting transcripts, insights, and analytics through a simple interface.<br><br>
Check the docs below or refer to our [user guide](https://support.meetgeek.ai/en/articles/11939580-mcp-server). 
<br>
If you're looking for the MeetGeek public MCP implementation please check [this guide](https://support.meetgeek.ai/en/articles/13491658-public-mcp-cloud-guide) instead

[![MCP Setup](https://img.youtube.com/vi/gNPReZdIWts/maxresdefault.jpg)](https://youtu.be/gNPReZdIWts?si=ZZt9d1_lDICqB-ax).



## Features

* **List Meetings:** Retrieve all meetings with pagination support
* **Get Meeting Details:** Fetch comprehensive metadata for any specific meeting
* **Get Meeting Transcripts:** Access full transcriptions with speaker identification and timestamps
* **Get Meeting Highlights:** Retrieve AI-generated key moments and insights
* **Get Meeting Summaries:** Access AI-powered meeting summaries and action items
* **Team Meetings:** Retrieve meetings for specific teams with filtering capabilities
* **Upload Recordings:** Import meeting recordings directly via download URLs

## Prerequisites

* **MeetGeek Account:** A valid MeetGeek account with API access
* **MeetGeek API Key:** You need an API key from your MeetGeek account settings
* **Node.js & npm:** Node.js (v14 or higher) and npm installed on your system
* **MCP-Compatible Client:** An MCP client like Claude Desktop, Cursor, or similar

## Installation and Configuration

This MCP server runs locally using Node.js. Follow these steps to set up and configure it with your MCP client.

### Local Installation

1. **Clone or download this repository:**
   ```bash
   git clone <repository-url>
   cd meetgeek-mcp-server
   ```

2. **Install dependencies:**
   ```bash
   npm install
   ```

3. **Build the server:**
   ```env
   npm run build
   ```

### Configure Your MCP Client

Update your MCP client's configuration file to include the MeetGeek server.

#### For Claude Desktop

Update your `claude_desktop_config.json` file (typically located in `~/Library/Application Support/Claude/` on macOS or `%APPDATA%\Claude\` on Windows):

```json
{
  "mcpServers": {
    "MeetGeek": {
      "command": "node",
      "args": ["/absolute/path/to/your/meetgeek-mcp-server/dist/index.js"],
      "env": {
        "MEETGEEK_API_KEY": "your_meetgeek_api_key_here",
        "MEETGEEK_BASE_URL": "https://api.meetgeek.ai"
      }
    }
  }
}
```

#### For Other MCP Clients

Refer to your specific MCP client's documentation for configuration details. The general pattern is:

```json
{
  "mcpServers": {
    "MeetGeek": {
      "command": "node",
      "args": ["/absolute/path/to/MeetGeek-mcp-server/dist/index.js"],
      "env": {
        "MEETGEEK_API_KEY": "your_meetgeek_api_key_here",
        "MEETGEEK_BASE_URL": "https://api.meetgeek.ai"
      }
    }
  }
}
```

**Important:** Replace `/absolute/path/to/your/meetgeek-mcp-server/` with the actual absolute path to your server file and `your_meetgeek_api_key_here` with your actual MeetGeek API key.

### Getting Your MeetGeek API Key

1. Log in to your MeetGeek account
2. Navigate to Integrations
3. Look for Public API Integration
4. Generate a new API key if you don't have one
5. Copy the API key for use in your configuration

## Usage

Once configured and your MCP client is restarted, you can use the following capabilities:

### Available Functions

* **`meetgeek:meetings`** - List all meetings with optional pagination
* **`meetgeek:meetingDetails`** - Get detailed information about a specific meeting
* **`meetgeek:transcript`** - Retrieve the full transcript of a meeting
* **`meetgeek:highlights`** - Get AI-generated highlights and key moments
* **`meetgeek:summary`** - Access meeting summaries and action items
* **`meetgeek:teamMeetings`** - List meetings for a specific team
* **`meetgeek:uploadRecording`** - Upload a recording via download URL

### Example Usage

Ask your AI assistant questions like:

* "Show me my recent meetings from MeetGeek"
* "Get the transcript for meeting ID abc123"
* "What were the key highlights from yesterday's team meeting?"
* "Summarize the main action items from our project meeting"
* "Upload this recording to MeetGeek: [URL]"

## Development

### Local Development Setup

1. **Install development dependencies (if not already installed):**
   ```bash
   npm install --save-dev nodemon
   ```

2. **Run in development mode:**
   ```bash
   npm run dev
   ```
   or if you don't have dev script configured:
   ```bash
   npx nodemon index.js
   ```

### Testing the Server

You can test the server directly by running it from the command line:

```bash
node index.js
```

The server should start and be ready to accept MCP protocol messages.

## Troubleshooting

### Common Issues

* **Server not connecting:** Ensure the absolute path in your MCP client configuration is correct
* **API key errors:** Verify your MeetGeek API key is valid and has the necessary permissions
* **Permission denied:** Make sure the `index.js` file is executable (`chmod +x index.js`)
* **Module not found:** Ensure all dependencies are installed (`npm install`)

### Debugging

* **Check server logs:** Run the server directly to see error messages and logs
* **Verify configuration:** Double-check your MCP client configuration file syntax
* **Test API key:** Verify your API key works by making direct API calls to MeetGeek
* **Client logs:** Check your MCP client's logs for connection and error information

### Restarting After Changes

**Important:** After making any changes to the server code or configuration, you must restart your MCP client for the changes to take effect.

## API Reference

This server implements the following MeetGeek API endpoints through MCP functions:

| Function | Description | Parameters |
|----------|-------------|------------|
| `meetings` | List meetings | `cursor` (optional), `limit` (optional) |
| `meetingDetails` | Get meeting metadata | `meetingId` (required) |
| `transcript` | Get meeting transcript | `meetingId` (required), `cursor` (optional), `limit` (optional) |
| `highlights` | Get meeting highlights | `meetingId` (required) |
| `summary` | Get meeting summary | `meetingId` (required) |
| `teamMeetings` | List team meetings | `teamId` (required), `cursor` (optional), `limit` (optional) |
| `uploadRecording` | Upload recording | `download_url` (required), `language_code` (required), `template_name` (optional) |

## Learn More

* [MeetGeek Website](https://meetgeek.ai/)
* [MeetGeek API Documentation](https://docs.meetgeek.ai/getting-started/introduction)
* [Model Context Protocol (MCP) Specification](https://modelcontextprotocol.io/introduction)
* [Claude Desktop MCP Setup Guide](https://modelcontextprotocol.io/quickstart/user)

## Support

For issues related to:
* **MCP Server:** Check the troubleshooting section above or create an issue in this repository
* **MeetGeek API:** Contact MeetGeek support
* **MCP Protocol:** Refer to the official MCP documentation

## License

This project is provided as-is for integration with MeetGeek's API through the Model Context Protocol.