# FrelyMCP

FrelyMCP links an MCP client to a chosen computer and its shared workspaces. Use it when an agent needs remote access to files or processes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: FrelyHQ
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FrelyHQ/frely-cli
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/frelymcp

## What it does

FrelyMCP gives an MCP client one account-level endpoint, `https://mcp.frely.cloud/mcp`, for computers connected through Frely. An agent can select a device, inspect or edit files, work with processes, and fetch web content. Access is limited to the workspaces you share.

Run `frely mcp start` on the computer, add the server to your client, and complete OAuth approval. The CLI can also expose local MCP servers, install Frely agents and skills, and publish a local Ollama or OpenAI-compatible runtime as a Frely provider.

The home directory is the default workspace; set `FRELY_WORKSPACE=/path` to share another path. A computer will not appear through FrelyMCP until `frely mcp start` is running on it.

## Requirements
- Remote server: `https://mcp.frely.cloud/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http frelymcp https://mcp.frely.cloud/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add frelymcp --url https://mcp.frely.cloud/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frelymcp": {
            "url": "https://mcp.frely.cloud/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "frelymcp": {
            "type": "http",
            "url": "https://mcp.frely.cloud/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http frelymcp https://mcp.frely.cloud/mcp
```

## When to use it
- connect an MCP client to a remote computer
- inspect and edit files in an approved workspace
- work with processes on a selected device
- expose a local MCP server to a remote client
- share a local model through Frely

## Example prompts
- Connect FrelyMCP to this project and show the top-level names in its workspace.
- Choose a device in FrelyMCP, read `README.md`, and list its active processes.
- Check the local MCP servers available through FrelyMCP and enable one for this client.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md