Frely MCP server

Q: How do I add Frely MCP to Claude Code?

Run `claude mcp add frely-cli -- npx -y frely-cli` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Frely MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Nov 11, 2026

frelyhq/frely-cli · typescript · Apache-2.0

Lets AI clients access your computers' files and run commands in approved folders, and share local models, through one Frely login.

Also known as FrelyHQ/frely-cli, frely-cli

stdio remote Developer Tools Workflow Automation Cloud Platforms

Install GitHub ↗

Stars: 9
Tools: —
Downloads, 30 days: 9,563
Latest version: 1.1.1
Last commit: Nov 11, 2026
License: Apache-2.0

What is Frely MCP?

Frely lets AI clients access your computers' files and run commands in approved folders, and share local models, through one Frely login.

Summary generated from the project's README

About Frely MCP server

Connecting web-based AI agents like ChatGPT or Claude to your local files and terminal commands is what FrelyMCP enables. By installing the Frely CLI on your machine, you can grant specific AI clients access to approved folders and command execution within an OS sandbox. This setup allows remote web agents to interact with your local environment through a single Freely login using OAuth authentication.

Developers can also use the CLI to manage local or remote devices and share local models. For example, using the command `frely service share model ollama` allows you to publish models from a local server as a personal provider. The system is designed for various agent hosts including Claude Code, Codex, and pi, providing specialized skills to manage permissions and remote control status via the `frely link` command.

What you can do with it

1Grant web agents local file accessYou can allow ChatGPT or Claude on the web to read and interact with specific folders on your computer.
2Share local AI modelsA developer can publish their local Ollama models to be used as a personal provider for others.
3Manage remote computer controlUsers can enable or disable the ability for remote clients to access their machine using specific CLI commands.
4Automate agent skill installationYou can instruct an AI agent with shell access to perform the entire installation and login process for you.

Written from the project's README. Every use case is checked against a quote from it.

How to install Frely MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add frely-cli -- npx -y frely-cli

~/.cursor/mcp.json

{
  "mcpServers": {
    "frely-cli": {
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "frely-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

$ code --add-mcp '{"name":"frely-cli","type":"stdio","command":"npx","args":["-y","frely-cli"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "frely-cli": {
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

$ codex mcp add frely-cli -- npx -y frely-cli

~/.codex/config.toml

[mcp_servers.frely-cli]
command = "npx"
args = ["-y", "frely-cli"]

$ gemini mcp add -s user frely-cli npx -- -y frely-cli

~/.gemini/settings.json

{
  "mcpServers": {
    "frely-cli": {
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesNot checked

README

View on GitHub

Frely CLI

Website · Docs · Freely · English · 简体中文

Frely CLI (frely-cli) connects AI agents to your devices: remote computers, local servers, and shared models. For web ChatGPT and Claude, it connects computers you choose to FrelyMCP so those clients can use the files and commands in the folders you allow. For your own agents (Claude Code, Codex, pi), it lets them run and update Skills from the terminal.

Features and Installation

Want web ChatGPT or Claude to access your devices?

Add FreelyMCP to web agents
Install Freely CLI on your computer

Want AI agents to access local or remote devices?

Install Freely CLI on your computer

Want to share local models with friends?

Install Freely CLI on your computer
Local model sharing: frely service share model ollama publishes a local model server's models as your personal Freely Provider. Details

Step-by-Step Instructions

Install Freely CLI on your computer

A. Let your agent install Freely CLI

Ask an agent that has a shell (Claude Code, Codex, pi) to install the CLI, sign in and install the Skill:

Install Freely CLI and the frely Skill on this computer. First ask the user for their email, and whether they also want to allow remote control of this computer (for example from ChatGPT or Claude on the web). Then, using that email, run the installer for this operating system: on macOS or Linux run curl -fsSL https://frely.cloud/install.sh | sh -s -- --quiet --email <my email>; on Windows PowerShell run curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1" -Quiet -Email <my email>. The installation emails me a 6-digit code: ask me for it, then run frely login --code <code> --host <your host: claude-code, codex, pi or generic> --quiet (add --link on if I agree to remote control; otherwise do not), and read the Skill it installs.

The installed frely Skill teaches the agent to use your account, and to suggest FreelyMCP only when a request needs it. This path does not expose this computer to remote clients; frely link on does. Details

B. Install Freely CLI manually

https://frely.cloud/install.sh and install.ps1 only install the program, for scripts and agents that need the CLI. You can also use npm (Node.js 22 or newer required):

# macOS / Linux
curl -fsSL https://frely.cloud/install.sh | sh
# For agents: quiet output (details on failure only), sends the login code email right away
curl -fsSL https://frely.cloud/install.sh | sh -s -- --quiet --email you@example.com

# Windows (PowerShell)
curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1"

Or with npm:

npm install --global --ignore-scripts frely-cli@latest

The installers verify SHA-256, download from GitHub Releases first, then fall back to npmmirror and npmjs. Details

Then sign in and install the Skill for your agent host:

frely login --email <you@example.com>   # Then run: frely login --code <6-digit code> [--host <host>] [--link on] (installs Skill; --link on also turns on remote control)
frely skill install --host <claude-code|codex|pi|workbuddy|codebuddy|generic>

Add FreelyMCP to web agents

Find the connectors section in your settings, add a new connector/MCP
Name the connector anything, we recommend FreelyMCP
For the connector URL, enter https://freely.cloud/mcp
For authentication, select OAuth

If you don't have a Freely account, you'll be directed to the Freely login page, where you can create a new account using your email.

ChatGPT Tutorial

Tutorial https://freely.cloud/docs/chatgpt

Claude Tutorial

Tutorial https://freely.cloud/docs/claude

Common Commands

Command	What it does
`frely skill install --host <host>`	Install the `frely` Skill for an agent host (`claude-code`, `codex`, `pi` or `generic`).
`frely link on`	Turn remote control on: sign in if needed, approve this computer in the browser, start the background service and print the MCP URL. Safe to re-run: it renews expired access and starts a stopped service.
`frely link off`	Turn remote control off: revoke access for every client and lock it on this computer, so only `frely link on` here turns it on again. The background service is uninstalled, or kept running for local Providers.
`frely link status`	Show whether remote control is on, off or not enabled yet, with the MCP URL, workspace, expiry and service state.
`frely link workspace add <path>`	Share another folder. `frely link workspace list` shows them all.
`frely doctor`	Check sign-in, installation, service and connection. `-v` for details.
`frely update`	Update to the latest version in place.
`frely login` / `frely logout`	Sign in or out of Freely account.
`frely sandbox proxy <url>`	Forward the command sandbox's network traffic to your own HTTP(S) proxy. Without it the CLI uses `HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY` and, on macOS, the system proxy. `--clear` removes it. A running background service restarts to apply the change.
`frely tunnel <host>:<port>`	Inside a sandboxed command: listen on `127.0.0.1` and forward TCP connections to `host:port` through the sandbox, for database and redis clients. `--local-port N` picks the local port.
`frely uninstall`	Remove Freely from this computer (lists everything first).

All commands and options: command reference. frely help --agent --json prints the full machine-readable contract.

Safety

File tools stay inside the shared workspaces and protect credential and shell start-up files. Commands run as your OS user inside an OS sandbox, and are refused where the computer cannot sandbox them. Clients hold OAuth tokens; the CLI keeps its own key in the system credential store. Is it safe? · Sandbox and permissions · Credential storage

Documentation

Help: cli.frely.cloud/docs (update, doctor, uninstall)
Contracts, for contributors: Device MCP · Device Relay transport · MCP OAuth contract · frely api · Freely Network (preview) · self-update · service maintenance

License and trademarks

frely-cli is licensed under the Apache License 2.0; see LICENSE. The Freely name, logos and product names are not licensed as trademarks; see TRADEMARKS.md. See CONTRIBUTING.md for development and SECURITY.md to report a vulnerability.

Read full README

Frely MCP questions

How do I add Frely MCP to Claude Code?

Run claude mcp add frely-cli -- npx -y frely-cli in your terminal. Add --scope user to make it available in every project.

How do I add Frely MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What authentication does FreelyMCP use?

Clients authenticate with OAuth, and the CLI keeps its own key in the system credential store.

Is it safe to let a client access my computer?

File tools stay inside the shared workspaces and protect credential and shell start-up files, and commands run as your OS user inside an OS sandbox.

How do I turn remote control on for a computer?

Run frely link on, which signs you in if needed, approves the computer in the browser, starts the background service and prints the MCP URL. frely link off revokes access for every client.

Can I share my local Ollama models?

Yes, running frely service share model ollama publishes a local model server's models as your personal Freely Provider.

Facts

Nov 14, 2026

Stars: 9
Downloads, 30 days: 9,563
Latest version: 1.1.1
Last commit: Nov 11, 2026
License: Apache-2.0
Transport: stdio, remote
Package: frely-cli

FrelyHQ ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/frelyhq/frely-cli.svg)](https://hostedmcp.org/servers/frelyhq/frely-cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

Frely MCP server

✓ VerifiedCommit Nov 11, 2026

frelyhq/frely-cli · typescript · Apache-2.0

Lets AI clients access your computers' files and run commands in approved folders, and share local models, through one Frely login.

Also known as FrelyHQ/frely-cli, frely-cli

stdio remote Developer Tools Workflow Automation Cloud Platforms

Install GitHub ↗

Stars: 9
Tools: —
Downloads, 30 days: 9,563
Latest version: 1.1.1
Last commit: Nov 11, 2026
License: Apache-2.0

What is Frely MCP?

Frely lets AI clients access your computers' files and run commands in approved folders, and share local models, through one Frely login.

Summary generated from the project's README

About Frely MCP server

What you can do with it

1Grant web agents local file accessYou can allow ChatGPT or Claude on the web to read and interact with specific folders on your computer.
2Share local AI modelsA developer can publish their local Ollama models to be used as a personal provider for others.
3Manage remote computer controlUsers can enable or disable the ability for remote clients to access their machine using specific CLI commands.
4Automate agent skill installationYou can instruct an AI agent with shell access to perform the entire installation and login process for you.

Written from the project's README. Every use case is checked against a quote from it.

How to install Frely MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add frely-cli -- npx -y frely-cli

~/.cursor/mcp.json

{
  "mcpServers": {
    "frely-cli": {
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "frely-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

$ code --add-mcp '{"name":"frely-cli","type":"stdio","command":"npx","args":["-y","frely-cli"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "frely-cli": {
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

$ codex mcp add frely-cli -- npx -y frely-cli

~/.codex/config.toml

[mcp_servers.frely-cli]
command = "npx"
args = ["-y", "frely-cli"]

$ gemini mcp add -s user frely-cli npx -- -y frely-cli

~/.gemini/settings.json

{
  "mcpServers": {
    "frely-cli": {
      "command": "npx",
      "args": [
        "-y",
        "frely-cli"
      ]
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesNot checked

README

View on GitHub

Frely CLI

Website · Docs · Freely · English · 简体中文

Features and Installation

Want web ChatGPT or Claude to access your devices?

Add FreelyMCP to web agents
Install Freely CLI on your computer

Want AI agents to access local or remote devices?

Install Freely CLI on your computer

Want to share local models with friends?

Install Freely CLI on your computer
Local model sharing: frely service share model ollama publishes a local model server's models as your personal Freely Provider. Details

Step-by-Step Instructions

Install Freely CLI on your computer

A. Let your agent install Freely CLI

Ask an agent that has a shell (Claude Code, Codex, pi) to install the CLI, sign in and install the Skill:

Install Freely CLI and the frely Skill on this computer. First ask the user for their email, and whether they also want to allow remote control of this computer (for example from ChatGPT or Claude on the web). Then, using that email, run the installer for this operating system: on macOS or Linux run curl -fsSL https://frely.cloud/install.sh | sh -s -- --quiet --email <my email>; on Windows PowerShell run curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1" -Quiet -Email <my email>. The installation emails me a 6-digit code: ask me for it, then run frely login --code <code> --host <your host: claude-code, codex, pi or generic> --quiet (add --link on if I agree to remote control; otherwise do not), and read the Skill it installs.

B. Install Freely CLI manually

https://frely.cloud/install.sh and install.ps1 only install the program, for scripts and agents that need the CLI. You can also use npm (Node.js 22 or newer required):

# macOS / Linux
curl -fsSL https://frely.cloud/install.sh | sh
# For agents: quiet output (details on failure only), sends the login code email right away
curl -fsSL https://frely.cloud/install.sh | sh -s -- --quiet --email you@example.com

# Windows (PowerShell)
curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1"

Or with npm:

npm install --global --ignore-scripts frely-cli@latest

The installers verify SHA-256, download from GitHub Releases first, then fall back to npmmirror and npmjs. Details

Then sign in and install the Skill for your agent host:

frely login --email <you@example.com>   # Then run: frely login --code <6-digit code> [--host <host>] [--link on] (installs Skill; --link on also turns on remote control)
frely skill install --host <claude-code|codex|pi|workbuddy|codebuddy|generic>

Add FreelyMCP to web agents

Find the connectors section in your settings, add a new connector/MCP
Name the connector anything, we recommend FreelyMCP
For the connector URL, enter https://freely.cloud/mcp
For authentication, select OAuth

If you don't have a Freely account, you'll be directed to the Freely login page, where you can create a new account using your email.

ChatGPT Tutorial

Tutorial https://freely.cloud/docs/chatgpt

Claude Tutorial

Tutorial https://freely.cloud/docs/claude

Common Commands

Command	What it does
`frely skill install --host <host>`	Install the `frely` Skill for an agent host (`claude-code`, `codex`, `pi` or `generic`).
`frely link on`	Turn remote control on: sign in if needed, approve this computer in the browser, start the background service and print the MCP URL. Safe to re-run: it renews expired access and starts a stopped service.
`frely link off`	Turn remote control off: revoke access for every client and lock it on this computer, so only `frely link on` here turns it on again. The background service is uninstalled, or kept running for local Providers.
`frely link status`	Show whether remote control is on, off or not enabled yet, with the MCP URL, workspace, expiry and service state.
`frely link workspace add <path>`	Share another folder. `frely link workspace list` shows them all.
`frely doctor`	Check sign-in, installation, service and connection. `-v` for details.
`frely update`	Update to the latest version in place.
`frely login` / `frely logout`	Sign in or out of Freely account.
`frely sandbox proxy <url>`	Forward the command sandbox's network traffic to your own HTTP(S) proxy. Without it the CLI uses `HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY` and, on macOS, the system proxy. `--clear` removes it. A running background service restarts to apply the change.
`frely tunnel <host>:<port>`	Inside a sandboxed command: listen on `127.0.0.1` and forward TCP connections to `host:port` through the sandbox, for database and redis clients. `--local-port N` picks the local port.
`frely uninstall`	Remove Freely from this computer (lists everything first).

All commands and options: command reference. frely help --agent --json prints the full machine-readable contract.

Safety

Documentation

Help: cli.frely.cloud/docs (update, doctor, uninstall)
Contracts, for contributors: Device MCP · Device Relay transport · MCP OAuth contract · frely api · Freely Network (preview) · self-update · service maintenance

License and trademarks

Read full README

Frely MCP questions

How do I add Frely MCP to Claude Code?

Run claude mcp add frely-cli -- npx -y frely-cli in your terminal. Add --scope user to make it available in every project.

How do I add Frely MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What authentication does FreelyMCP use?

Clients authenticate with OAuth, and the CLI keeps its own key in the system credential store.

Is it safe to let a client access my computer?

File tools stay inside the shared workspaces and protect credential and shell start-up files, and commands run as your OS user inside an OS sandbox.

How do I turn remote control on for a computer?

Run frely link on, which signs you in if needed, approves the computer in the browser, starts the background service and prints the MCP URL. frely link off revokes access for every client.

Can I share my local Ollama models?

Yes, running frely service share model ollama publishes a local model server's models as your personal Freely Provider.

Facts

Nov 14, 2026

Stars: 9
Downloads, 30 days: 9,563
Latest version: 1.1.1
Last commit: Nov 11, 2026
License: Apache-2.0
Transport: stdio, remote
Package: frely-cli

FrelyHQ ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/frelyhq/frely-cli.svg)](https://hostedmcp.org/servers/frelyhq/frely-cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

Frely MCP server

What is Frely MCP?

About Frely MCP server

What you can do with it

How to install Frely MCP

Install Frely MCP in Claude Code

Install Frely MCP in Cursor

Install Frely MCP in VS Code

Install Frely MCP in VS Code CLI

Install Frely MCP in Claude Desktop

Install Frely MCP in Codex

Install Frely MCP in Codex config.toml

Install Frely MCP in Gemini CLI

Install Frely MCP in Gemini settings.json

Automated checks

README

Frely CLI

Features and Installation

Want web ChatGPT or Claude to access your devices?

Want AI agents to access local or remote devices?

Want to share local models with friends?

Step-by-Step Instructions

Install Freely CLI on your computer

A. Let your agent install Freely CLI

B. Install Freely CLI manually

Add FreelyMCP to web agents

ChatGPT Tutorial

Claude Tutorial

Common Commands

Safety

Documentation

License and trademarks

Frely MCP questions

Frely MCP server

What is Frely MCP?

About Frely MCP server

What you can do with it

How to install Frely MCP

Install Frely MCP in Claude Code

Install Frely MCP in Cursor

Install Frely MCP in VS Code

Install Frely MCP in VS Code CLI

Install Frely MCP in Claude Desktop

Install Frely MCP in Codex

Install Frely MCP in Codex config.toml

Install Frely MCP in Gemini CLI

Install Frely MCP in Gemini settings.json

Automated checks

README

Frely CLI

Features and Installation

Want web ChatGPT or Claude to access your devices?

Want AI agents to access local or remote devices?

Want to share local models with friends?

Step-by-Step Instructions

Install Freely CLI on your computer

A. Let your agent install Freely CLI

B. Install Freely CLI manually

Add FreelyMCP to web agents

ChatGPT Tutorial

Claude Tutorial

Common Commands

Safety

Documentation

License and trademarks

Frely MCP questions