Introduction to Remote.com MCP
Learn what Remote.com MCP is, how it authenticates, which OAuth scopes it requires, and which clients it supports.
Use Remote.com MCP to connect an MCP-compatible AI client securely to your Remote employment data. Remote.com MCP is a hosted Model Context Protocol server that lets the AI answer questions, build artifacts, and run workflows over your live workforce data without exports, custom integrations, or hand-rolled API glue.
If you've used Remote's REST API, think of MCP as the conversational layer on top of it: same data model, same permissions, but reached through natural language instead of HTTP calls.
Prerequisites
Before you connect a client:
- Sign in with a Remote account that can access the employment data you want to use.
- Confirm your role in Remote has permission to access the relevant company-level or employee-level data.
Authentication
Remote.com MCP uses OAuth 2.0 Authorization Code with PKCE through the same browser sign-in you already use for Remote. You don't create API keys, store client secrets, or configure environment variables for MCP access.
The MCP client registers dynamically, sends you through Remote sign-in, and receives access based on your authenticated Remote account.
Required OAuth scopes
Remote.com MCP does not require you to request OAuth scopes manually.
| Requirement | Value |
|---|---|
| Required OAuth scopes | None to configure |
| Access source | Your signed-in Remote account and role |
| Tool visibility | Limited to the tools your Remote permissions allow |
Webhook dependency
Remote.com MCP does not require a webhook subscription to connect or retrieve data. Clients discover available tools at connection time and send authenticated requests over the active MCP connection.
What you can reach through it
Remote.com MCP exposes the domains that make up global employment at Remote:
- Employees and employment records
- Contracts and contract amendments
- Payroll runs, pay schedules, and deadlines
- Time off, leave balances, and policies
- Org structure and reporting lines
- Legal entities and country-specific requirements
- Timesheets, billing, and invoices
Clients discover the available tools automatically at connection time, so there's nothing to hardcode in your integration.
Who it's for
Remote.com MCP is available to employer users who can reach company-level employment data and employees who can reach their own employment data. You don't choose a scope, the server reads access from your Remote account when you sign in, and the AI client only sees the tools your role allows.
How it's secured
- OAuth 2.0 with PKCE. The same browser sign-in you already use for Remote. No API keys to mint, no client secrets to store, no environment variables to configure.
- Role and RLS aware. Every request runs through Remote's existing permission model and Row-Level Security. The MCP layer can't see anything your account can't already see.
- Read-only today. All externally available tools are read. Write tools will be added later, behind explicit approval gates.
What it isn't
- It isn't a replacement for the Remote API when you're building a deterministic integration. For backend-to-backend automation, keep using the API directly.
- It isn't a chatbot Remote runs. The AI client is yours (Claude, Cursor, Codex, or anything else that speaks MCP). Remote provides the data layer.
- It isn't tied to one vendor. Any client that implements the MCP standard can connect.
Compatible clients
Remote.com MCP is tested against:
- Claude Desktop and claude.ai
- Claude Code
- Cursor
Other MCP-compatible clients should work as long as they support OAuth 2.0 with Dynamic Client Registration over streamable HTTP.
Updated about 6 hours ago