Skip to main content
Unthread supports the Model Context Protocol (MCP), allowing you to connect your AI assistant to your Unthread workspace.

​
Setup Instructions

​
Claude.ai (Web)

  1. Go to claude.ai and sign in
  2. Navigate to Settings → Connectors → Add custom connector
  3. Enter a name (e.g., “Unthread”) and the server URL: 
    https://app.unthread.io/api/mcp
  1. Click Add and follow the authorization prompt
  2. Sign in with your Unthread account when prompted
  3. Authorize the connection to grant Claude access to your workspace
You’ll be asked to authorize access to your Unthread workspace. This uses secure OAuth authentication - your password is never shared with Claude.

​
Claude Code (CLI)

  1. Open your Claude Code configuration file at ~/.claude.json
  2. Add Unthread to the mcpServers section:
{
  "mcpServers": {
    "unthread": {
      "url": "https://app.unthread.io/api/mcp"
    }
  }
}
  1. Restart Claude Code
  2. When you first use an Unthread tool, you’ll be prompted to authenticate via your browser

​
Cursor

  1. Open Cursor Settings → MCP → Add new global MCP server
  2. This opens your ~/.cursor/mcp.json file. Add Unthread to the mcpServers section:
{
  "mcpServers": {
    "Unthread": {
      "url": "https://app.unthread.io/api/mcp"
    }
  }
}
  1. Save the file and restart Cursor. The Unthread MCP should now show up in your Cursor Settings.
  2. When you first use an Unthread tool, you’ll be prompted to authenticate via your browser

​
Available Capabilities

Once connected, your AI assistant can use these tools:
ToolDescription
get_current_userGet information about the authenticated user
list_conversationsList and filter support conversations
get_conversation_by_idGet details of a specific conversation
get_time_series_analyticsRetrieve analytics data over time
list_custom_fieldsList available ticket type fields
get_custom_fieldGet details of a specific custom field

​
Example Prompts

Try asking your AI assistant:
  • “List my open conversations”
  • “Show me conversations from the last week”
  • “What’s our ticket volume trend this month?”
  • “Find the conversation about the billing issue”

​
Troubleshooting

​
”Authorization failed” error

Make sure you’re signed in to Unthread with the correct account. The OAuth flow should open a browser window - if it doesn’t, check if pop-ups are blocked.

​
Security

  • OAuth 2.0: We use industry-standard OAuth 2.0 with PKCE for secure authentication
  • No password sharing: Your Unthread credentials are never shared with AI assistants
  • Scoped access: The AI assistant can only access data you have permission to view
  • Revocable: You can disconnect the integration at any time from your Unthread settings
For more details on our security practices, visit unthread.io/security.