Skip to content
MCP server

Octadesk MCP by usefulapi

Search tickets, read conversations and people; create and update tickets and people in…

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Octadesk MCP by usefulapi

Octadesk MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://octadesk.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "octadesk": {
      "url": "https://octadesk.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Read directly from the server.

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}.

Octadesk MCP by usefulapi 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