Customer Relation

Gorgias MCP Server

Connect your account, then chat with AI to run tools.

Gorgias is a customer support platform that centralizes communication by integrating various channels like email, chat, and social media to streamline customer interaction and ticket management.

19 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Gorgias — workflow patterns, data models, and gotchas for your AI agent.

Gorgias

E-commerce customer support helpdesk. Centralizes email, chat, social media, SMS, and phone into one dashboard with deep Shopify/BigCommerce/Magento integrations.

Data Model

  • Tickets — support conversations. Have status (open/closed), priority (low/normal/high/urgent), channel (email/chat/api/phone/sms/facebook/instagram/twitter), assigned agent, assigned team, tags, and messages. Core entity.
  • Messages — individual messages within tickets. Include customer replies, agent responses, and internal notes (channel='internal-note'). Each has body_text, body_html, sender, and channel.
  • Customers — customer records with email, name, contact channels, notes, custom fields, and external_id for e-commerce linking.
  • Tags — labels for categorizing tickets. Have name, color, description, and usage count.
  • Users — support agents. Have role (admin/agent/bot), email, active status. Used for ticket assignment.
  • Teams — groups of agents. Used for ticket routing and assignment.
  • Macros — canned responses and automation snippets. Contain actions (set response text, add tags, change status).
  • Rules — automation rules that trigger on events (ticket created, message received) and execute actions (auto-tag, route, apply macro).
  • Views — saved ticket filters. Views have items (tickets matching the filter criteria).
  • Satisfaction Surveys — CSAT survey responses with scores and comments.
  • Integrations — connected channels (email inboxes, chat widgets, social accounts).
  • Custom Fields — custom attributes on tickets or customers, scoped by object_type.

Key Relationships

  • Ticket → has many Messages, Tags, and belongs to Customer
  • Ticket → optionally assigned to User (agent) and/or Team
  • View → contains Tickets matching its filter
  • Macro → defines actions that can be applied to Tickets

Common Workflows

  1. Triage: List open tickets → review → assign to agent/team → add tags
  2. Respond: Get ticket messages → add internal note or reply → update status
  3. Organize: Create/manage tags → apply to tickets for filtering
  4. Monitor: Check satisfaction surveys → review CSAT scores
  5. Automate: Review rules → understand routing and auto-tagging logic

API Notes

  • All IDs are integers
  • Pagination uses cursor-based pagination (pass cursor from response)
  • Partial updates: only send fields you want to change on PUT
  • Ticket trash is soft-delete (can be restored)
  • Tag delete is permanent

Tools in this Server (19)

Gorgias Delete Tag

Permanently delete a tag by ID. This removes the tag from all tickets. Use gorgias_get_tags to find tag IDs.

Gorgias Delete Ticket

Trash a support ticket by ID (soft-delete — moves to trash, can be restored). Use gorgias_get_tickets to find ticket IDs.

Gorgias Get Account

Get your Gorgias account details including domain, subscription status, trial dates, business hours, and satisfaction survey settings.

Gorgias Get Customers

Get customers. Pass customer_id to retrieve a single customer with contact channels, notes, and custom fields, or omit to list customers. Filter by em...

Gorgias Get Custom Fields

Get custom field definitions for a given object type. Pass object_type='ticket' or 'customer' to see what custom fields are configured.

Gorgias Get Integrations

Get connected integrations (email, chat, social channels, e-commerce platforms). Pass integration_id for a single integration's config, or omit to lis...

Gorgias Get Macros

Get macros (canned responses and automation snippets). Pass macro_id to retrieve a single macro with its actions, or omit to list all macros. Macros c...

Gorgias Get Messages

Get messages. Pass ticket_id to list all messages in a ticket (conversation thread), or pass message_id to retrieve a single message with full body. M...

Gorgias Get Rules

Get automation rules. Pass rule_id to retrieve a single rule with triggers and conditions, or omit to list all rules. Rules automate ticket routing, t...

Gorgias Get Surveys

Get customer satisfaction surveys (CSAT). Pass survey_id to retrieve a single survey response, or omit to list all survey responses with scores and co...

Gorgias Get Tags

Get tags used to categorize tickets. Pass tag_id to retrieve a single tag, or omit to list all tags with name, color, and usage count. Use gorgias_ups...

Gorgias Get Teams

Get support teams. Pass team_id to retrieve a single team, or omit to list all teams with members. Team IDs are used for ticket assignment.

Gorgias Get Tickets

Get support tickets. Pass ticket_id to retrieve a single ticket with full details (messages, tags, customer info, assignment), or omit to list tickets...

Gorgias Get Users

Get support agents (users). Pass user_id to retrieve a single agent's profile, or omit to list all agents with role, email, and activity status. Agent...

Gorgias Get Views

Get saved ticket views (filters). Pass view_id to retrieve a single view's definition, or pass view_id + items=true to get the tickets matching that v...

Gorgias Upsert Customer

Create or update a customer. Pass customer_id to update an existing customer, or omit and provide email to create a new one. Only send the fields you ...

Gorgias Upsert Message

Add a message to a ticket — reply to the customer, send an internal note, or log a conversation. Set channel to 'internal-note' for private notes visi...

Gorgias Upsert Tag

Create or update a tag. Pass tag_id to update, or omit and provide name to create. Tags are used to categorize and filter tickets.

Gorgias Upsert Ticket

Create or update a support ticket. Pass ticket_id to update an existing ticket's status, priority, assignment, or tags. Omit ticket_id and provide cus...

Frequently Asked Questions

What is the Gorgias MCP server?

Gorgias is a customer support platform that centralizes communication by integrating various channels like email, chat, and social media to streamline customer interaction and ticket management. It provides 19 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Gorgias to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/gorgias. Authentication is handled automatically.

How many tools does Gorgias provide?

Gorgias provides 19 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Gorgias require?

Gorgias uses API Key. Gorgias requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Gorgias to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/gorgias

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Related MCP Servers

More customer relation integrations you might like

Affinity

Affinity is a relationship intelligence CRM platform designed for deal flow and relationship managem...

32 tools
Customer Relation
AgileCRM

AgileCRM is a customer relationship management platform that helps businesses manage sales, marketin...

11 tools
Customer Relation
Aircall

Aircall is a cloud-based call center and phone system that integrates with various CRM and Helpdesk ...

9 tools
Customer Relation
Apptivo

Apptivo is a cloud-based suite of CRM applications designed to manage sales, marketing, and support ...

5 tools
Customer Relation
Attio Activity

Attio communication and activity data — email threads, call recordings with transcripts, and meeting...

8 tools
Customer Relation
Attio Admin

Attio workspace administration — manage objects, attributes, select options, statuses, list schemas,...

24 tools
Customer Relation

Ready to use Gorgias?

Sign in to connect your credentials and start running tools from the chat.

Gorgias MCP Server & Skill — 19 Tools