Gorgias-MCP-Server
3.2
If you are the rightful owner of Gorgias-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server for interacting with the Gorgias helpdesk API, providing tools and resources for managing tickets, customers, and other Gorgias functionality.
Gorgias MCP Server
An MCP server for interacting with the Gorgias helpdesk API. This server provides tools and resources for managing tickets, customers, and other Gorgias functionality.
## Setup
1. Clone this repository
2. Install dependencies:
```
npm install
```
3. Create a `.env` file based on `.env.example` with your Gorgias credentials:
```
GORGIAS_DOMAIN=your-domain.gorgias.com
GORGIAS_USERNAME=your-username
GORGIAS_API_KEY=your-api-key
```
Or for OAuth apps:
```
GORGIAS_DOMAIN=your-domain.gorgias.com
GORGIAS_ACCESS_TOKEN=your-oauth-access-token
```
## Running the Server
Start the server:
```
npm run dev
```
## Testing with MCP Inspector
Test the server with the MCP Inspector:
```
npm run inspect
```
This will open a web interface where you can test all the available tools and resources.
## Available Tools
### Tickets
- `list_tickets`: List tickets from Gorgias helpdesk
- `get_ticket`: Get a specific ticket by ID
- `create_ticket`: Create a new ticket in Gorgias
- `add_message_to_ticket`: Add a message to an existing ticket
### Customers
- `list_customers`: List customers from Gorgias
- `get_customer`: Get a specific customer by ID
## Available Resources
- `gorgias://tickets`: List all tickets
- `gorgias://ticket/{id}`: Get a specific ticket by ID
## Authentication
This server supports two authentication methods:
1. API Key authentication (username/API key)
2. OAuth token authentication
Configure your preferred method in the `.env` file.
