Customer Relation

Gorgias MCP Server

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

Triage ecommerce support tickets, read customer history, and summarize inbox queues from chat — connect your Gorgias helpdesk once in MCPBundles and let an AI agent handle the tab-shuffling.

Best forE-commerce Support LeadsCX ManagersShopify Store OperatorsCustomer Success

Try this workflow

Morning inbox triage

For Acme Retail in Gorgias, open our main support views and summarize today's open tickets — urgent items first, grouped by issue type, with customer email and the last reply on each thread.

Managed
19 tools
Agent guide included

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

Browse all tools

What you can do with Gorgias

Built for

E-commerce Support Leads, CX Managers, Shopify Store Operators, Customer Success Teams

Example workflows

Morning inbox triage

Uses saved views and ticket lists for a daily standup brief.

Try this

For Acme Retail in Gorgias, open our main support views and summarize today's open tickets — urgent items first, grouped by issue type, with customer email and the last reply on each thread.

Customer context before reply

Combines customer lookup, messages, and internal notes for faster replies.

Try this

Pull the Gorgias ticket history for customer jordan@harbor-analytics.com, list recent orders-related threads, and draft a short internal note with what we already promised them.

CSAT pulse check

Turns CSAT data into actionable follow-ups for support leads.

Try this

Summarize Gorgias satisfaction survey responses from the last seven days for Bright Smile Co — average score, common complaints, and tickets that need a follow-up.

Tag and route cleanup

Connects tags, rules, and ticket patterns for queue hygiene.

Try this

List Gorgias tags used on shipping-delay tickets this week, show which automation rules apply those tags, and suggest a cleaner routing setup for our peak season queue.

Context to know first

What is Gorgias MCP?

It lets AI agents in Cursor, Claude, or ChatGPT work with your Gorgias helpdesk — tickets, customers, tags, macros, views, and satisfaction scores — after you connect your Gorgias account in MCPBundles.

Who is this for?

E-commerce support teams who live in Gorgias and want inbox summaries, customer lookups, and ticket triage from chat instead of clicking through every queue.

Does it work with Shopify stores?

Yes. Gorgias is built for ecommerce support — agents can read tickets, customer records, and order-related context tied to your connected store when your Gorgias account has that data.

Related editorial

Gorgias E-Commerce Support Workflows with AI

How AI agents triage inbox queues, pull customer history before replies, review CSAT trends, and clean up tags without living inside the helpdesk UI.

Read article

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 saved views first, then list tickets with that view_id (open inbox, closed, custom queues). Never list tickets without view_id except a one-time exploratory call — unscoped lists are huge and slow. The list-tickets API does not accept status, channel, or assignee query params.
  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)
  • List tickets: use view_id (from views) or customer_id — not status, channel, or assignee query params. Default summary=true on list returns compact rows; pass ticket_id for full ticket detail.
  • 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. Resolve tag IDs from the tag listing when needed.

Gorgias Delete Ticket

Trash a support ticket by ID (soft-delete — moves to trash, can be restored). Fetch the ticket by ticket_id first when you need to confirm it exists.

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 (capitalized, as Gorgias requires).

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. L...

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. Create or updat...

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 (saved ticket filters such as open inbox, closed, or custom queues). Pass view_id to retrieve a single view's definition, or pa...

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 Gorgias MCP?

It lets AI agents in Cursor, Claude, or ChatGPT work with your Gorgias helpdesk — tickets, customers, tags, macros, views, and satisfaction scores — after you connect your Gorgias account in MCPBundles.

Who is this for?

E-commerce support teams who live in Gorgias and want inbox summaries, customer lookups, and ticket triage from chat instead of clicking through every queue.

Does it work with Shopify stores?

Yes. Gorgias is built for ecommerce support — agents can read tickets, customer records, and order-related context tied to your connected store when your Gorgias account has that data.

Can an agent reply to customers automatically?

Agents can read tickets, add internal notes, apply tags, and update ticket status when your workflow calls for it. You stay in control of what gets sent to shoppers versus kept as team notes.

How do I connect?

Open the Gorgias skill page in MCPBundles, add your connection, and sign in with the same credentials you use for your Gorgias helpdesk.

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

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

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Gorgias and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Gorgias will appear under Not connected — select it and click Connect to complete OAuth.
Name: Gorgias
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/gorgias
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Gorgias?

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

Gorgias MCP Server