gorgias-automation
π―SkillInstallation
npx skills add composiohq/awesome-claude-skills --skill gorgias-automationRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/Gorgias AutomationInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/gorgias-automation/ - All projects
~/.claude/skills/gorgias-automation/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βAutomate e-commerce customer support workflows in Gorgias -- manage tickets, customers, tags, and teams through natural language commands.
Gorgias Automation
Automate your Gorgias helpdesk operations directly from Claude Code. Create, update, and triage support tickets, manage customers, and organize your support team -- all without leaving your terminal.
Toolkit docs: composio.dev/toolkits/gorgias
Setup
- Add the Rube MCP server to your Claude Code config with URL:
https://rube.app/mcp - When prompted, authenticate your Gorgias account through the connection link provided
- Start automating your support workflows with natural language
Core Workflows
1. List and Filter Tickets
Retrieve tickets with filtering by status, channel, assignee, date range, and more.
Tool: GORGIAS_LIST_TICKETS
List all open tickets from the email channel created in the last 7 days
Key parameters:
status-- filter by ticket status (e.g., "open", "closed")channel-- filter by channel (e.g., "email", "chat")assignee_user_id/assignee_team_id-- filter by assigned agent or teamcreated_from/created_to-- ISO date range filterslimit(max 100) /offset-- pagination controlsorder_by/order_dir-- sorting options
2. Create and Update Tickets
Create new tickets or update existing ones with assignment, priority, and status changes.
Tools: GORGIAS_CREATE_TICKET, GORGIAS_UPDATE_TICKET, GORGIAS_GET_TICKET
Create a high-priority ticket for customer 12345 about a missing order with subject "Order #9876 not delivered"
GORGIAS_CREATE_TICKETrequirescustomer_id; acceptssubject,status,priority,channel,messages,tagsGORGIAS_UPDATE_TICKETrequiresticket_id; all other fields are optional partial updatesGORGIAS_GET_TICKETretrieves full ticket details byticket_id
3. Manage Ticket Tags
Add tags to tickets for categorization, routing, and reporting.
Tools: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS
Add tags 101 and 202 to ticket 5678, then show me all tags on that ticket
GORGIAS_ADD_TICKET_TAGSrequiresticket_idandtag_ids(array of integers)GORGIAS_LIST_TICKET_TAGSrequiresticket_idto retrieve current tags
4. Customer Management
Create new customers or merge duplicate customer records.
Tools: GORGIAS_CREATE_CUSTOMER, GORGIAS_MERGE_CUSTOMERS, GORGIAS_LIST_CUSTOMERS
Create a new customer named "Jane Doe" with email jane@example.com and phone channel
GORGIAS_CREATE_CUSTOMERrequiresname; acceptsemail,channels(array withtypeandvalue),external_id,address,dataGORGIAS_MERGE_CUSTOMERSrequiressource_customer_idandtarget_customer_id-- source is merged into targetGORGIAS_LIST_CUSTOMERSretrieves customers with filtering options
5. Team and Account Operations
List teams, retrieve account info, and inspect ticket custom fields.
Tools: GORGIAS_LIST_TEAMS, GORGIAS_GET_TEAM, GORGIAS_GET_ACCOUNT, GORGIAS_LIST_TICKET_FIELD_VALUES
Show me all support teams in our Gorgias account
GORGIAS_GET_ACCOUNTreturns account-level metrics and configurationGORGIAS_LIST_TEAMS/GORGIAS_GET_TEAMmanage team lookupGORGIAS_LIST_TICKET_FIELD_VALUESreturns custom field values for a given ticket
6. Activity and Event Tracking
Monitor ticket activity and customer event history.
Tools: GORGIAS_LIST_EVENTS
List recent events to see what activity has happened across our support queue
GORGIAS_LIST_EVENTSprovides an activity timeline with filtering options
Known Pitfalls
- Pagination required:
GORGIAS_LIST_TICKETSuseslimit/offsetpagination. Failing to loop through pages will miss older tickets and produce incomplete data. - Filter specificity: Missing or overly broad filters on
GORGIAS_LIST_TICKETScan overload the export or omit the desired reporting window. Always setcreated_from/created_tofor time-bound queries. - Custom fields are separate: Key business KPIs may only exist in custom fields. You must query
GORGIAS_LIST_TICKET_FIELD_VALUESexplicitly to include them. - Rate limits: High-volume exports across
GORGIAS_LIST_TICKETSand related endpoints can hit Gorgias rate limits. Add backoff and resume from the last offset. - Auth errors: 401/403 responses on any Gorgias tool indicate token or permission issues. Do not treat partial data as a complete dataset.
Quick Reference
| Tool Slug | Description |
|---|---|
GORGIAS_LIST_TICKETS | List tickets with filters (status, channel, date, assignee) |
GORGIAS_GET_TICKET | Retrieve a specific ticket by ID |
GORGIAS_CREATE_TICKET | Create a new ticket (requires customer_id) |
GORGIAS_UPDATE_TICKET | Update ticket fields (requires ticket_id) |
GORGIAS_ADD_TICKET_TAGS | Add tags to a ticket |
GORGIAS_LIST_TICKET_TAGS | List all tags on a ticket |
GORGIAS_LIST_TICKET_FIELD_VALUES | List custom field values for a ticket |
GORGIAS_CREATE_CUSTOMER | Create a new customer (requires name) |
GORGIAS_MERGE_CUSTOMERS | Merge two customer records |
GORGIAS_LIST_CUSTOMERS | List customers with filters |
GORGIAS_LIST_TEAMS | List all teams |
GORGIAS_GET_TEAM | Retrieve a specific team |
GORGIAS_GET_ACCOUNT | Retrieve account information |
GORGIAS_LIST_EVENTS | List activity events with filters |
Powered by Composio
More from this repository10
A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.
A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.
A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.
A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.
A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.
A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.
A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.
A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.
A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.
A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.