miniDesk MCP server

miniDesk MCP server

Work your miniDesk customer support inbox from Claude, Cursor, VS Code or any MCP client.

miniDesk is a customer support inbox for live chat, email and web forms. This is its official MCP server. It lets an AI assistant work your support queue much like a person would: see what is waiting, read a conversation, look up a customer, check your reference documents, and write a reply.

The server is hosted by miniDesk. There is nothing to install or run: point your client at this URL.

https://api.minidesk.ai/mcp

Get a token

1. Sign in to miniDesk. The free plan works.
2. Go to Settings → MCP and create a credential. Only a workspace owner can.
3. Copy it. It starts with mdskmcp and is shown once.

A token works in one workspace only. No tool takes a workspace parameter, so there is nothing for a confused agent to point somewhere else. Revoke a token in Settings → MCP and the next call with it is refused.

Connect

Claude Code

claude mcp add --transport http minidesk https://api.minidesk.ai/mcp \
  --header "Authorization: Bearer mdsk_mcp_YOUR_TOKEN"

Run /mcp inside a session to check it connected.

Cursor

Add this to ~/.cursor/mcp.json, or to .mcp.json at the root of one project:

{
  "mcpServers": {
    "minidesk": {
      "url": "https://api.minidesk.ai/mcp",
      "headers": {
        "Authorization": "Bearer mdsk_mcp_YOUR_TOKEN"
      }
    }
  }
}

VS Code

Add this to .vscode/mcp.json, then use Copilot Chat in Agent mode:

{
  "servers": {
    "minidesk": {
      "type": "http",
      "url": "https://api.minidesk.ai/mcp",
      "headers": {
        "Authorization": "Bearer mdsk_mcp_YOUR_TOKEN"
      }
    }
  }
}

Any other client

Any client or SDK that speaks Streamable HTTP works. Every call is a single JSON-RPC POST, with no session to open or keep alive:

curl -X POST https://api.minidesk.ai/mcp \
  -H "Authorization: Bearer $MINIDESK_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

[!WARNING]

A config file with a token in it is a secret. Keep project-level files like .mcp.json out of git.

Tools

Read

Write

Shortened. The full README is on GitHub.