Skip to content

ReMCP

Secure OAuth control of your paired computers: files, terminal and browser.

Install: claude mcp add --transport http remcp https://remcp.site/mcp

Works with Claude Code, Codex, Cursor, Gemini CLI · 1 GitHub stars

Install

One-click install

Remote server
Claude Code (no install link, copy and run)
$claude mcp add --transport http remcp https://remcp.site/mcp

Buttons open the app on your computer and ask you to confirm before anything is added.

$claude mcp add --transport http remcp https://remcp.site/mcp
mcp.json (Cursor, Claude Desktop, Windsurf)
{
  "mcpServers": {
    "remcp": {
      "url": "https://remcp.site/mcp"
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

Your computer. Your tools. One secure MCP connection.

Website · Plugins · Docs · Tool reference · Security · Privacy · Support

ReMCP connects a computer you own or administer to ChatGPT & Codex, Cursor, Claude Code, Gemini CLI, Kiro, Cline, or another MCP client. The device agent makes an outbound connection only — no inbound port, no tunnel, no third-party desktop relay. This repository contains the public device client/runtime, portable Agent Plugin metadata, the Gemini CLI extension manifest, official MCP Registry metadata, and the host-specific OpenAI and Anthropic plugin packaging.

Packages

Package What it is
@remcp/remcp The device client: pairing, the outbound agent, the background service, and the usage-metrics switch.
@remcp/runtime The first-party local runtime: 83 MCP tools for files, images, binary transfer, archives, screenshots, search, terminal/process work, native desktop UI, loopback browser CDP, diagnostics, lightweight documents, and narrowly scoped runtime preferences, with two direct dependencies.

Install

Open ReMCP → Connect a machine. The page detects the computer's operating system and shows the correct one-command flow.

Windows PowerShell — no preinstalled Node.js, npm, npx, or winget required:

irm https://remcp.site/i | iex

ReMCP keeps its Windows runtime privately under %LOCALAPPDATA%\ReMCP; it does not install Node.js globally or add the private runtime directory to the system PATH.

macOS / Linux: Node.js 22.5 or newer provides the current npm/npx distribution path.

npx --yes @remcp/remcp@latest connect

The browser can also generate a one-time pairing command. Run that exact command on the computer you want to connect; it installs the runtime and registers the background service.

Pairing codes are generated in the authenticated workspace, expire automatically, and are single-use. Do not invent or reuse a code from documentation.

Commands

Command Purpose
remcp start Start the device agent when no managed background service is already running
remcp status Show device, client/runtime versions, managed-agent state, update consistency and server reachability as JSON
remcp doctor Status plus a real local-runtime handshake and filesystem diagnostics
remcp install Install or repair the persistent user service
remcp update Update the client and runtime, then restart the service
remcp uninstall Stop and remove the user service
remcp uninstall --purge Remove the service and the global packages
remcp telemetry [status|on|off] Show or change usage metrics for the client and the runtime
remcp godmode [status|on|off] Show or change this computer's local unrestricted mode
remcp --version Print the installed client version

Plugins

For users, ReMCP is catalog-first:

Install from your AI host → sign in to ReMCP → use your paired computers.

You do not need to paste an MCP server URL, edit a manifest, clone this repository, or configure a local path just to use the published plugin.

Shareable install guides:

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

Explore related