mattcoatsworth/Gorgias-MCP-Server
3.3
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.
Tools
6
Resources
0
Prompts
0
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.
