Quick Start Guide

Connecting Remote.com MCP to your AI client takes three steps: add the connector, point it at https://mcp.remote.com/mcp, and sign in to Remote when the browser opens. The exact UI varies by client; the flow is the same.

Before you start

You'll need:

• A Remote.com account (employer or employee).
• An MCP-compatible AI client. Claude Desktop, claude.ai, Claude Code, and Cursor are tested. Any client that supports the MCP standard with OAuth should work.

Connect via claude.ai or Claude Desktop

1. Open Settings → Connectors.
2. Click Add custom connector and fill in:
   1. Name: Remote.com MCP
   2. URL: https://mcp.remote.com/mcp
3. Save. Your browser will open Remote's login page.
4. Sign in with your Remote credentials and authorize the connection.

The connector shows as connected once you're back, and Claude discovers the available tools on its own.

Connect via Claude Code

From your terminal:

claude mcp add --scope user --transport http remote-com-mcp https://mcp.remote.com/mcp

Restart Claude Code, run /mcp, select remote-com-mcp, and authenticate when the browser prompts you.

Connect via Cursor, Codex, or other MCP clients

Add the server to your .mcp.json (or the equivalent config file your client uses):

{
  "mcpServers": {
    "remote-com-mcp": {
      "type": "http",
      "url": "https://mcp.remote.com/mcp"
    }
  }
}

Restart the client and authenticate when prompted.

Verify it works

Ask the AI a simple question that requires Remote data.

For employer users:

▎ "How many employees do we have, and which countries are they in?"

For employees:

▎ "How many PTO days do I have left this year?"

If the answer is grounded in your actual Remote data, you're connected.

Multiple Remote accounts?

If your email is tied to more than one Remote profile (for example, a manager profile via SSO and a personal employee profile), the sign-in flow will show all available profiles when you authenticate. Pick the one you want to use for the session.

You can also add the connector more than once and authenticate each instance with a different account. Give them distinct names (for example, Remote.com MCP (Manager) and Remote.com MCP (Personal)) so it's clear which one your AI client is using for a given prompt.

To switch later, disconnect a connector in your client's settings and reconnect, or just enable the one you need.