Overview
Connect AI assistants like Claude to your SparrowDesk account using the Model Context Protocol (MCP)
The SparrowDesk MCP server lets AI assistants like Claude connect to your SparrowDesk account to read and manage tickets, contacts, Knowledge Base content, tags, companies, and team data.
What is MCP?
Model Context Protocol (MCP) is an open standard that connects AI assistants to external tools and data sources. Instead of copy-pasting ticket IDs or switching tabs, your AI can interact with SparrowDesk data as part of the conversation.
What you can do
Once connected, your AI assistant can:
- Read conversations: fetch a single ticket or list conversations filtered by status, priority, assignee, or team
- Reply to conversations: add a public reply or an internal note
- Create tickets: open a new conversation with a subject, description, priority, and assignee
- Manage conversations: update or delete conversations and manage custom conversation fields
- Manage contacts and companies: create, update, delete, bulk import, or look up contacts and list companies
- Manage Knowledge Base content: list help centers, collections, and articles, then create, update, publish, or archive KB content
- Check your team: list team members or see who you're authenticated as
- Use tags: list tags for organizing support data
Authentication
Authentication is handled via OAuth, with no API keys to copy or manage. The first time you connect, your MCP client will open a browser window to log in with your SparrowDesk account. After that, the connection is maintained automatically.
Available tools
Tools mirror the SparrowDesk Developer API. Knowledge Base collections and related endpoints require VIEW_COLLECTIONS and MANAGE_COLLECTIONS, which are included in the MCP default OAuth scope list. Other Knowledge Base behavior may still depend on additional scopes or account features.
Account
| Tool | Description |
|---|---|
get_me | Current account information, including subdomain, company, timezone, and language |
Conversations
| Tool | Description |
|---|---|
get_conversation | Retrieve a conversation by ID |
list_conversations | List conversations with optional filters |
create_conversation | Create a new conversation/ticket |
update_conversation | Update subject, status, priority, assignee, team, or custom fields |
delete_conversation | Delete a conversation |
list_conversation_replies | List replies for a conversation |
add_conversation_reply | Add a reply or internal note |
Conversation fields
| Tool | Description |
|---|---|
list_conversation_fields | List ticket custom field definitions |
get_conversation_field | Get one conversation field by ID |
create_conversation_field | Create a custom conversation field |
update_conversation_field | Update a conversation field |
Contacts and companies
| Tool | Description |
|---|---|
list_contacts | List contacts with search, email, phone, and pagination filters |
get_contact | Retrieve a contact by ID |
create_contact | Create a contact |
update_contact | Update a contact |
delete_contact | Delete a contact |
bulk_create_contacts | Bulk create contacts and return a job ID |
get_bulk_job_status | Poll bulk contact job status |
list_companies | List companies |
Contact fields
| Tool | Description |
|---|---|
list_contact_fields | List contact field definitions |
Members and tags
| Tool | Description |
|---|---|
list_members | List team members |
list_tags | List tags |
Knowledge Base
| Tool | Description |
|---|---|
list_helpcenters | List help centers |
list_collections | List Knowledge Base collections for a help center |
get_collection | Get a collection with subcollections and articles |
create_collection | Create a Knowledge Base collection |
list_articles | List articles for a help center |
get_article | Get one article |
create_article | Create an article as a draft or publish it |
update_article | Update an article draft or publish it |
archive_article | Archive an article |