# Octadesk MCP by usefulapi

> Octadesk MCP by usefulapi is an MCP server. Search tickets, read conversations and people; create and update tickets and people in Octadesk. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/octadesk/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/octadesk
- **MCP Registry name:** io.usefulapi/octadesk
- **Listing updated:** 2026-11-13

## About

Search tickets, read conversations and people; create and update tickets and people in Octadesk.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http octadesk https://octadesk.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://octadesk.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "octadesk": {
      "url": "https://octadesk.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "octadesk": {
      "type": "http",
      "url": "https://octadesk.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "octadesk": {
      "serverUrl": "https://octadesk.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "octadesk": {
      "type": "http",
      "url": "https://octadesk.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `octadesk_search_tickets`: Search tickets with optional filters. Returns the page of tickets plus paging fields (total_count, search_id, next_page_url). For the next page, pass the same filters with the returned search_id and page + 1. GET /tickets/search.
- `octadesk_get_ticket`: Get one ticket by its number, with its fields and status. GET /tickets/{number}.
- `octadesk_get_ticket_interactions`: List the interactions of one ticket: replies, internal notes and property changes, in order. GET /tickets/{number}/interactions.
- `octadesk_list_requester_tickets`: List the tickets of one requester. Pass last_number to read past the last ticket of the previous page. GET /tickets.
- `octadesk_list_custom_ticket_lists`: List the saved custom ticket lists (views) of the account. GET /tickets/custom-lists.
- `octadesk_find_person_by_email`: Find one person (requester or agent) by exact e-mail address. GET /persons?email=.
- `octadesk_get_person`: Get one person by id. GET /persons/{id}.
- `octadesk_search_requesters`: Search requesters (customers who open tickets) by e-mail or name. GET /persons/requesters.
- `octadesk_search_agents`: Search agents (staff who work tickets) by e-mail or name. GET /persons/agents.
- `octadesk_create_ticket`: Create a ticket. Common keys of `ticket`: summary, requester ({ email, name } or { id }), idGroupAssigned, idAssigned, idPriority, idCurrentStatus, idSubject, tags (string array), comments ({ internal: { content } } for an agent-only note, { public: { content } } for a reply the requester can read). POST /tickets.
- `octadesk_update_ticket`: Change fields of one ticket, for example status, priority, assignee or group. Send only the fields to change. A `comments.public` entry is e-mailed to the requester. PUT /tickets/{number}.
- `octadesk_create_person`: Create a person (requester or agent). Send the person fields, for example email and name. POST /persons.
- `octadesk_update_person`: Change fields of one person. Send only the fields to change. PATCH /persons/{id}.

## FAQ

### How do I add Octadesk MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http octadesk https://octadesk.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/octadesk-mcp-by-usefulapi
