ReMCP MCP server
Commit Nov 15, 2026Connects your local computer to AI clients like ChatGPT, Claude, and Cursor via a secure outbound connection for remote tool execution.
Also known as antonbaider/remcp
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.258
- Last commit
- Nov 15, 2026
- License
- MIT
What is ReMCP MCP?
ReMCP connects your local computer to AI clients like ChatGPT, Claude, and Cursor via a secure outbound connection for remote tool execution.
Summary generated from the project's README
About ReMCP MCP server
ReMCP provides a way to link your local machine to AI clients like ChatGPT, Claude, Cursor, and Gemini CLI. It works by establishing a secure outbound connection from your device to the AI, which means you do not need to open inbound ports, set up tunnels, or use third-party desktop relays. This setup allows remote tool execution while keeping your local environment protected.
The system consists of a device client and a local runtime. The runtime includes 84 built-in tools for tasks such as file management, terminal operations, screenshots, and browser interaction via loopback CDP. Developers can install the service on Windows, macOS, or Linux using simple one-command scripts that do not require preinstalled Node.js or npm. Once paired, you can manage the agent through commands like remcp start, remcp status, and remcp update.
What you can do with it
- 1Execute local terminal commandsAn AI client can perform terminal and process work directly on your machine.
- 2Manage local files and archivesYou can instruct an AI to manipulate files and create archives on your computer.
- 3Automate browser interactionsThe server allows an AI to interact with a browser using the Chrome DevTools Protocol.
- 4Connect remote AI to local toolsUsers can bridge the gap between cloud-based models and local hardware without complex networking.
Written from the project's README. Every use case is checked against a quote from it.
How to install ReMCP MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ReMCP MCP in Claude Code
$ claude mcp add --transport http remcp https://remcp.site/mcpInstall ReMCP MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"remcp": {
"url": "https://remcp.site/mcp"
}
}
}Install ReMCP MCP in VS Code
.vscode/mcp.json
{
"servers": {
"remcp": {
"type": "http",
"url": "https://remcp.site/mcp"
}
}
}Install ReMCP MCP in VS Code CLI
$ code --add-mcp '{"name":"remcp","type":"http","url":"https://remcp.site/mcp"}'Install ReMCP MCP in Codex
$ codex mcp add remcp --url https://remcp.site/mcpInstall ReMCP MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.remcp] url = "https://remcp.site/mcp"
Install ReMCP MCP in Gemini CLI
$ gemini mcp add -s user --transport http remcp https://remcp.site/mcpInstall ReMCP MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"remcp": {
"url": "https://remcp.site/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableantonbaider/remcp is public and reachablegithub.com/antonbaider/remcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-14github.com/antonbaider/remcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubReMCP 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: 84 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 — no Node.js or npm needed beforehand:
curl -fsS https://remcp.site/i.sh | sh
The installer asks before installing a vetted, checksum-verified Node.js runtime into your user
profile when needed. It then runs the production-compatible ReMCP version. No sudo required.
The downloaded script is parsed in full before any installation actions begin.
If Node.js is already installed, the advanced npm shortcut is npx --yes @remcp/remcp@latest connect.
For inspecting the script before running it, open https://remcp.site/i.sh in your browser.
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:
- ChatGPT plugin (direct): https://chatgpt.com/plugins/plugin_asdk_app_6aaaba1295a4819195a4987e18e43428
- ChatGPT & Codex guide: https://remcp.site/install/chatgpt
- Claude Code: https://remcp.site/install/claude
ChatGPT & Codex / OpenAI
ChatGPT and Codex share OpenAI's public plugin directory.
- Open the published ReMCP plugin listing.
- Check that ReMCP is available for your ChatGPT account or workspace.
- Choose Install plugin.
- If prompted, choose Connect and complete ReMCP OAuth.
- In ChatGPT, use @ReMCP when you want to invoke it explicitly. In Codex, use Sources → Use plugins → ReMCP.
If ReMCP is not visible yet, the listing or rollout is not available to that account. There is no manual MCP endpoint an ordinary plugin user needs to configure while waiting.
Claude Code / Anthropic
ReMCP was submitted through Claude Platform on September 18, 2026 and currently shows Submitted and pending review.
After approval:
- Open https://claude.com/plugins. In Claude or Claude Desktop, you can also use Customize → Plugins → + → Browse plugins.
- Search for ReMCP and confirm it supports Claude Code.
- Choose Install.
- Complete ReMCP authorization if Claude asks you to connect.
- Ask Claude Code to use ReMCP on a computer already paired to your account.
While the listing is under review, ordinary users do not need to add a marketplace, clone this repository, or paste an MCP endpoint. Developer and reviewer workflows live in the technical guide.
Start with Plugin overview →.
Cursor and the wider MCP ecosystem
ReMCP publishes host-native metadata for coding agents plus directory records for MCP discovery:
| Host / directory | User path | Status |
|---|---|---|
| Cursor | Add https://remcp.site/mcp as a remote MCP server in Cursor settings, then authorize. |
manual MCP setup |
| Gemini CLI | Install from the Extension Gallery when indexed, or run gemini extensions install https://github.com/getremcp/remcp. |
gallery discovery enabled |
| VS Code | Configure the remote MCP endpoint in an MCP-capable client. | manual MCP setup |
| Kiro Powers | Import https://github.com/getremcp/remcp from Add Custom Power → Import power from GitHub while the curated listing is reviewed. |
submitted |
| Cline | Restored PR #347 (original #125) | Open, awaiting external review; original fork was deleted 26 Oct 2026 |
| Kilo Marketplace | Restored PR #498 (original #480) | Open, awaiting external review; original fork was deleted 26 Oct 2026 |
| Docker MCP Registry | Restored PR #6171 (original #5159) | Open, awaiting external review; original fork was deleted 26 Oct 2026 |
| MCP Find | PR #316 | Submitted 24 Oct 2026; fork-safe validation pending and directory review required |
| MCP Server Finder | Free directory | Repo checked absent 25 Oct 2026; editorial email submission sent 25 Oct, review pending |
| FindMCP | Free submission portal | ReMCP submission ID 321 accepted 25 Oct 2026; review pending |
| Few Servers | Free editorial form | 25 Oct 2026: listing/claim request emailed to editor; external review pending; not verified listed |
| AgenticSkills | Free MCP server submission | Accepted for weekly editorial review 25 Oct 2026; public listing not yet confirmed |
| MCP Harbor | Free submission portal | Docsy and ReMCP submitted 24 Oct 2026; ReMCP awaiting external review/daily indexing, not yet verified listed |
| Plug and Ship | Public ReMCP page | Free launch accepted 24 Oct 2026; daily board scheduled 12 Nov 2026, not yet launched |
| LibHunt | Public ReMCP listing | Published and verified HTTP 200 on 24 Oct 2026; free submission automatically approved |
| Ext Ops Panel | Public ReMCP MCP profile | Auto-indexed from official MCP Registry, verified public 25 Oct 2026; not host endorsement |
| Walnut World | Public ReMCP source page | GitHub-source listing published 25 Oct 2026, independently verified in Chrome; ownership unclaimed |
| MCPRepository | ReMCP listing | Existing listing confirmed via duplicate-detection API and HTTP 200 on 24 Oct 2026 |
| MCP Market | Public ReMCP listing | publicly indexed; existing-listing confirmation 24 Oct 2026 |
| Punkpeye Awesome MCP Servers | Merged PR #14685 | verified merged 18 Oct 2026; public source-install catalog |
| AI Anytime Awesome MCP Servers | ReMCP listing PR #314 | merged 24 Oct 2026; listed in the public GitHub directory |
| Sagargupta Awesome MCP Servers | ReMCP listing PR #214 | merged 24 Oct 2026; listed in the public GitHub directory |
| TensorBlock Awesome MCP Servers | Merged PR #4495 | accepted 25 Oct 2026 into upstream catalog; public API sync may lag |
| VoltAgent Official MCP Servers | PR #56 | Closed by upstream maintainer 25 Oct 2026, not merged |
| Awesome Public MCP Servers | PR #84 | submitted 25 Oct 2026; explicitly discloses mutating paired-device tools, review pending |
| Awesome MCP Tools | PR #21 | submitted 25 Oct 2026; remote OAuth computer access tools, review pending |
| PenguinMiaou Awesome Claude Code Plugins | PR #11 | submitted 25 Oct 2026; community review pending, not Anthropic endorsement |
| itgoyo Awesome Claude Code | PR #20 | submitted 25 Oct 2026; community review pending, not Anthropic endorsement |
| Claude Plugins Radar | PR #4 | submitted 25 Oct 2026; community review pending, not Anthropic endorsement |
| ClaudeMods | Editorial issue #35 | Submitted 25 Oct 2026; bot/editor review pending |
| Habito Awesome MCP Servers | PR #298 | submitted 25 Oct 2026; external curator review pending, no platform endorsement |
| DhanushNehru Awesome MCP Servers | PR #128 | submitted 25 Oct 2026; external curator review pending, no platform endorsement |
| Awesome Productivity MCP Servers | PR #48 | submitted 25 Oct 2026; external curator review pending, no platform endorsement |
| WunderCorp Awesome MCP | PR #155 | submitted 25 Oct 2026; external curator review pending, no platform endorsement |
| Awesome Codex | PR #32 | submitted 25 Oct 2026; awaiting independent review |
| Awesome AI Coding Tools | PR #8 | submitted 25 Oct 2026; awaiting independent review |
| Awesome MCP Collection | PR #73 | submitted 25 Oct 2026; awaiting independent review |
| Albertchamberlain Awesome-MCP | PR #117 | Submitted 25 Oct 2026; independent review pending, not published |
| Epistates Awesome MCP DevTools | PR #24 | Submitted 25 Oct 2026; independent review pending, not published |
| Backblaze Awesome Agent Infrastructure | PR #44 | Submitted 25 Oct 2026; awaiting maintainer review |
| Awesome DevOps AI | PR #78 | Submitted 25 Oct 2026; awaiting maintainer review |
| awesome-mcp.tools (adw0rd) | Existing upstream listing | Confirmed in public main 25 Oct 2026, canonical getremcp/remcp URL; no duplicate PR |
| TrackMCP | Submission form | Accepted 25 Oct 2026, email confirmation/review pending; not yet verified publicly listed |
| Best-of MCP Servers | Restored PR #575 (original #562) | Open, awaiting external review; original fork was deleted 26 Oct 2026 |
| mcpHQ Awesome MCP Servers | Submission PR | open, awaiting maintainer review |
| ToolSDK MCP Registry | Merged PR #1019 | merged 25 Oct 2026 |
| MobinX Awesome MCP List | Submission PR | open, awaiting maintainer review |
| Ever Works Awesome MCP Servers | PR #213 | Submitted 24 Oct 2026; full ReMCP detail page awaiting catalog review |
| Awesome Claude Code Plugins | PR #822 | Submitted 24 Oct 2026; external community review pending |
| Awesome Gemini CLI Extensions | ReMCP PR #95 | Submitted 24 Oct 2026; review pending |
| AlexMili Awesome MCP | Merged ReMCP PR #327 | Published in upstream README; merged 24 Oct 2026, commit 158a622; verified 25 Oct |
| Collabnix Awesome MCP Lists | PR #265 | Submitted 24 Oct 2026; pending third-party review |
| mctrinh Awesome MCP Servers | PR #180 | Submitted 24 Oct 2026; pending review |
| Awesome MCP ZH | PR #839 | Submitted 24 Oct 2026; Chinese-language entry pending review |
| Wagner Awesome DevOps MCP Servers | PR #113 | submitted 24 Oct 2026; external review pending |
| Awesome DevOps MCP Servers | PR #381 | submitted 24 Oct 2026; external review pending |
| MindPal Awesome Remote MCP Servers | PR #231 | submitted 24 Oct 2026; awaiting remote catalog review |
| YuzeHao Awesome MCP Servers | PR #719 | submitted 24 Oct 2026; review pending |
| Awesome Remote MCP Servers (jaw9c) | PR #1637 | submitted 24 Oct 2026; external review pending |
| Brethof AI Awesome MCP Servers | ReMCP PR #54 | submitted, awaiting review |
| Docker MCP Registry | ReMCP PR #5159 | submitted, review required |
| CheckMCP | Free audit submission | received 24 Oct 2026; pending public audit/listing |
| MCP Index | Submission portal | received 24 Oct 2026; pending review |
| ProMCP | Free submission | accepted 24 Oct 2026; pending manual review |
| MCP Servers | Free submission | accepted 24 Oct 2026; pending review |
| Launch MCP | Submission status | pending after verified non-duplicate submission 24 Oct 2026; not yet published |
| MCPizy | Free ReMCP submission | Received 25 Oct 2026 (ID web_mvnk77mz_gwrdi7); independent review pending |
| MCPfinder | Submission portal | submitted through free tier 24 Oct 2026; approval pending |
| Kilo Marketplace | PR #480 | submitted, awaiting independent review |
| MCP.Directory | Publisher submission | direct ReMCP GitHub URL submitted successfully 24 Oct 2026; approval not verified |
| Smithery (retired) | Smithery shutdown notice; the former ReMCP listing returns 404. | unavailable since 31 Oct 2026 |
| Glama | Open the ownership-verified connector at https://glama.ai/mcp/connectors/site.remcp/re-mcp. | verified / healthy |
| Awesome Remote MCP Servers | Open the community directory; ReMCP is listed under Developer Tools after PR #435 was merged. | listed |
| Official MCP Registry | Search for io.github.getremcp/remcp; GitHub resolves the project release URL antonbaider/remcp to the transferred getremcp repository, so this Registry namespace remains the active identity. |
published |
The same ReMCP OAuth account and paired computers sit behind every route. Marketplace and directory surfaces change discovery; they do not create separate ReMCP backends.
Distribution manifests, direct install commands, and review links are documented in PLUGINS.md → and DISTRIBUTION.md →.
Developer / reviewer internals
Host-specific manifests, MCP configuration, validation commands, submission artifacts, and local development workflows remain documented separately:
The OpenAI files and Claude files deliberately do not overwrite each other. Release checks fail if either host-specific contract drifts from the shared ReMCP version or production endpoint.
Use ReMCP with Docsy
For source-linked developer documentation alongside local computer access, combine ReMCP with the separate Docsy AI / MCP Plugin. Docsy exposes five read-only public documentation tools (resolve-library-id, list-library-versions, query-docs, search, fetch) through https://docsy.remcp.site/mcp/registry and requires its own OAuth 2.1 authorization. ReMCP's device tools and Docsy's documentation tools remain separate services.
ReMCP MCP questions
How do I add ReMCP MCP to Claude Code?
Run claude mcp add --transport http remcp https://remcp.site/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ReMCP MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does ReMCP connect to my computer?
The device agent makes an outbound connection only, meaning no inbound ports, tunnels, or third-party desktop relays are required.
What tools are available in the ReMCP runtime?
The runtime includes 84 MCP tools covering files, images, binary transfer, archives, screenshots, search, terminal/process work, and native desktop UI.
Do I need Node.js installed to use ReMCP on Windows?
No, the Windows PowerShell installation command does not require preinstalled Node.js, npm, npx, or winget.
How do I pair a new machine?
You can use a one-time pairing command generated by the ReMCP website and run it on the computer you wish to connect.