Set up the Freshservice MCP server | MintMCP

On this page

The Freshservice MCP server lets AI agents read and manage IT service desk resources — tickets, assets, users, service catalog items, and knowledge base articles in your Freshservice instance. This guide covers enrolling in the Early Access Program, creating a Freshworks OAuth app, and adding the server to MintMCP.

Prerequisites

Add Freshservice to MintMCP

Freshservice hosts its MCP server at your organization's subdomain:

https://<your-domain>.freshservice.com/mcp

Replace <your-domain> with your Freshservice subdomain — the part before .freshservice.com in your Freshservice URL.

Freshservice is available as a recommended server in the MintMCP MCP store. The per-user OAuth flow installs it from the Recommended servers list; the API key alternative is added manually by URL.

Per-user OAuth lets each team member authenticate with their own Freshservice account, so actions are attributed to that user and respect their existing permissions.

Create a Freshworks OAuth app

  1. Go to freshworks.dev and log in with your Freshworks Developer account.

  2. Click the Settings icon (top-right corner).

  3. In the OAuth Credentials section, click Create OAuth Credentials.

  4. On the Create New OAuth Credentials form, enter a Name (for example, MintMCP) and a Description.

  5. In the Redirect URL field, add https://app.mintmcp.com/oauth/callback. Use the + button to add more URLs if you need them.

  6. In the Add Scopes panel, open the Select products to add scope dropdown and choose Freshservice.

  7. Use the Search permissions box to select the Freshservice scopes your agents need — tickets, assets, agents, requesters, service catalog, and solutions cover the full set of MCP tools. Selected scopes appear in the Selected Scopes panel.

  8. Click Create Credentials.

  9. Copy the Client ID and Client Secret from the credentials page.

Configure in MintMCP

  1. In MintMCP, go to MCP store > Manage store.
  2. Find Freshservice under Recommended servers and click to install it.
  3. In the setup dialog, set the server URL to https://<your-domain>.freshservice.com/mcp, replacing <your-domain> with your Freshservice subdomain.
  4. Paste the Client ID and Client Secret from the Freshworks OAuth app you created. The recommended server uses the OAuth metadata Freshservice advertises, so you don't set an Authorization URL or Token URL — setting them manually points at an endpoint that returns not found, and the connection fails.
  5. Click Save.

Freshservice API keys are personal tokens tied to each user's account. Each team member uses their own key, so access and actions reflect their own Freshservice permissions.

Find your Freshservice API key

  1. Log in to Freshservice.
  2. Click your profile avatar (top-right) → Profile settings.
  3. Complete the security verification if prompted.
  4. Copy the API key shown on the profile settings page.

Configure in MintMCP

  1. In MintMCP, go to MCP store > Manage store.
  2. Click + Add an MCP to your registry → Connect to an MCP by URL.
  3. Enter https://<your-domain>.freshservice.com/mcp as the server URL.
  4. Set Connection type to Per-user credentials.
  5. Set Authorization method to Bearer Token.
  6. Open Bearer Token Advanced Settings and clear the Authorization Header Prefix field — delete the default Bearer value and leave it empty, since Freshservice expects the token directly in the Authorization header without a prefix.
  7. Click Create.

Each user is prompted to enter their own Freshservice API key when they first connect through MintMCP.

Security considerations

Troubleshooting

"Authorization failed" with HTTP 403 after the consent screen. OAuth completed and a token was issued, but Freshservice rejected the MCP connection — this is an account permission, not a MintMCP misconfiguration. The UI labels it "Authorization failed," though the authorization itself succeeded. Confirm that:

Next steps