Gorgias MCP Server

What is Gorgias MCP Server?

An MCP server for interacting with the Gorgias helpdesk API. It provides tools and resources for managing tickets, customers, and other Gorgias functionality.

How to use Gorgias MCP Server?

Clone the repository, install dependencies with npm install, create a .env file with your Gorgias credentials (either API key or OAuth token), then start the server with npm run dev. Test with npm run inspect.

Key features of Gorgias MCP Server

• List, get, and create tickets in Gorgias
• Add messages to existing tickets
• List and get customers from Gorgias
• Offers gorgias://tickets and gorgias://ticket/{id} resources
• Supports both API key and OAuth authentication

Use cases of Gorgias MCP Server

• Automate ticket management workflows via MCP
• Integrate Gorgias customer data with AI assistants
• Add messages to tickets programmatically
• Retrieve ticket details for support automation

FAQ from Gorgias MCP Server

What authentication methods are supported?

The server supports API key authentication (username/API key) and OAuth token authentication.

What environment variables are required?

You need to set GORGIAS_DOMAIN, and either GORGIAS_USERNAME/GORGIAS_API_KEY or GORGIAS_ACCESS_TOKEN in a .env file.

How do I test the server?

Run npm run inspect to open a web interface with the MCP Inspector for testing all available tools and resources.

What runtime does the server require?

Node.js, with dependencies installed via npm install.

What data does the server access?

It accesses Gorgias helpdesk data: tickets, customers, and messages. All data stays within the user's Gorgias domain.