Skip to main content

​
Setup

The Gomry MCP server is a hosted remote MCP endpoint. You don’t install anything locally — you generate a token, paste a URL into your AI client, and you’re done.

​
1. Generate a token

1

Open the MCP settings page

In your Gomry dashboard, go to Organization Settings → MCP.
The MCP tab is only visible to admins and owners of an organization.
2

Click Generate Token

A new token is created and the full MCP URL is shown once:
Copy this URL immediately — the raw token is never shown again.
3

(Optional) Revoke previous tokens

Generating a new token automatically revokes any prior token for the same user + org. You’ll always have at most one active token at a time per organization you belong to.
Treat the token like a password. Anyone with this URL can read your organization’s data through MCP. Don’t paste it in shared docs, screenshots, or chat. Revoke it from the same page if it leaks.

​
2. Connect your AI client

  1. Open Settings → Connectors (or Tools, depending on the version).
  2. Click Add a connector → Custom MCP server.
  3. Paste the URL you copied:
  4. Save. Claude will call tools/list and show the available Gomry tools in the picker.

​
3. Verify it works

In your client, ask:
“List my events.”
The assistant should invoke the list_events tool and return your organization’s events. If you see a 401 error, the token is missing or revoked. If you see “tool not found,” your privileges don’t include the required scope (see Available tools).

​
Authentication details

The MCP endpoint accepts the token in any of these forms — clients vary in which they use: Claude typically uses the URL ?token= for the initial handshake and switches to Authorization: Bearer for subsequent tool calls. Both refer to the same token.

​
Revoking a token

Open Organization Settings → MCP and click Revoke. Within five minutes (server-side cache TTL), the token stops working everywhere. Generate a fresh one any time — revocation is the safe path when in doubt.

​
Errors you might hit