freescout

# FreeScout Plugin

FreeScout helpdesk integration for Claude Code - manage support tickets and streamline customer support workflows.

## Features

- **Ticket Management**: Fetch, analyze, and update support tickets
- **Smart Analysis**: Automatic issue classification and solution suggestions
- **Draft Responses**: Create draft replies for review before sending
- **Team Collaboration**: Add internal notes and manage assignments
- **Powerful Search**: Find tickets by status, assignee, keywords, and time

## Installation

```bash
claude /plugin install ./plugins/freescout
```

## Configuration

Set the following environment variables:

```bash
export FREESCOUT_API_URL="https://your-freescout-instance.com"
export FREESCOUT_API_KEY="your-api-key"
export FREESCOUT_DEFAULT_USER_ID="123"  # Optional: default user for notes
```

## Commands

| Command | Description |
|---------|-------------|
| `/ticket-get <ticket>` | Fetch and display a ticket |
| `/ticket-analyze <ticket>` | Analyze issue type, root cause, and solution |
| `/ticket-reply <ticket>` | Create a draft reply for a ticket |

## Available MCP Tools

- `freescout_get_ticket` - Fetch ticket by ID or URL
- `freescout_analyze_ticket` - Analyze issue and suggest solution
- `freescout_add_note` - Add internal team note
- `freescout_update_ticket` - Update status/assignment
- `freescout_create_draft_reply` - Create draft response
- `freescout_get_ticket_context` - Get customer context
- `freescout_search_tickets` - Search with filters
- `freescout_get_mailboxes` - List available mailboxes

## Example Usage

```
# Get a specific ticket
/ticket-get #1234

# Analyze and draft a response
/ticket-analyze https://support.example.com/conversation/5678
/ticket-reply 5678

# Search for unassigned tickets
"Show me all unassigned active tickets"
```

## License

MIT