install-mcp
A simple CLI to install MCP servers into any client - auth included!
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/supermemoryai--install-mcp)HTML
<a href="/listings/supermemoryai--install-mcp"><img src="/api/listings/supermemoryai--install-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
A CLI tool to install and manage MCP servers.
Installing MCPs is a huge pain, so I made a CLI tool to make it easier.
Usage
The CLI now supports multiple installation methods with automatic detection:
Simple package names
npx install-mcp mcp-package-name --client claude-desktop
Scoped packages
npx install-mcp @org/mcp-server --client claude-desktop
Full commands (for custom arguments)
npx install-mcp 'npx some-mcp-server --custom-args' --client claude-desktop
Remote URLs (with automatic naming)
npx install-mcp https://mcp.example.com/server --client claude-desktop
The tool automatically:
- Converts simple package names to `npx package-name` - Preserves full commands as-is - Infers server names from package names or URLs (e.g., `mcp.example.com` → `mcp-example-com`) - Handles OAuth authentication for remote servers
Supermemory project support
When installing a server hosted on `https://api.supermemory.ai/*`, you can pass a project name via `--project`. This is a convenience alias for adding the header `x-sm-project: <value>`.
Rules:
- Only applies to URL installs targeting `https://api.supermemory.ai/*`. - Values must not contain spaces. - If you omit `--project` for these URLs, you'll be prompted. Pressing Enter uses `default`. - The value is injected as a header alongside any `--header` flags.
Examples:
# Explicit project npx install-mcp https://api.supermemory.ai/servers/my-server \ --client cursor \ --project myproj # Prompted for project (Enter defaults to "default") npx install-mcp https://api.supermemory.ai/servers/my-server --client cursor
Warp users: the generated config will include `--header "x-sm-project: <value>"` in the `args` array when installing Supermemory URLs.
Headers Support
You can pass headers for authentication or other purposes using the `--header` flag:
# Single header npx install-mcp https://api.example.com/mcp --client claude-desktop --header "Authorization: Bearer token123" # Multiple headers npx install-mcp https://api.example.com/mcp --client claude-desktop \ --header "Authorization: Bearer token123" \ --header "X-API-Key: secret-key"
OAuth Authentication for Remote Servers
When installing remote servers (URLs), the CLI will ask if the server uses OAuth authentication:
npx install-mcp https://api.example.com/mcp --client claude-desktop # Output: Does this server use OAuth authentication? (Y/n)
You can bypass this prompt using the `--oauth` flag:
# Automatically run OAuth authentication npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth yes # Skip OAuth authentication entirely npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth no
If you answer yes, the authentication flow:
- Runs automatically before installation - Handles OAuth flows seamlessly in the background - **Authentication state is shared globally** - once you authenticate with a server, that authentication is automatically available to all MCP clients - No need to re-authenticate when using the same server in different clients
# Output: Running authentication for https://api.example.com/mcp
If authentication fails, you'll see:
Authentication failed. Use the client to authenticate.
If the server doesn't use OAuth (you answer no), the installation proceeds directly without authentication.
This ensures secure access to remote servers while maintaining flexibility for servers that don't require OAuth.
Supported Clients
The `--client` flag specifies which MCP client you're installing for:
- `claude-desktop` - `cline` - `roo-cline` - `windsurf` - `witsy` - `enconvo` - `cursor` - `vscode` - `gemini-cli` - `claude-code` - `goose` - `zed` - `opencode` - `warp` (outputs config to copy/paste into Warp's cloud-based settings) - `codex` (OpenAI's Codex CLI tool) - `droid` (Factory.AI's Droid CLI tool)
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 146 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Install MCP CLI
- ### A CLI tool to install and manage MCP servers.
- Installing MCPs is a huge pain, so I made a CLI tool to make it easier.
- ## Usage
- The CLI now supports multiple installation methods with automatic detection:
- ### Simple package names
- ```bash
- npx install-mcp mcp-package-name --client claude-desktop
- ```
- ### Scoped packages
- ```bash
- npx install-mcp @org/mcp-server --client claude-desktop
- ```
- ### Full commands (for custom arguments)
- ```bash
- npx install-mcp 'npx some-mcp-server --custom-args' --client claude-desktop
- ```
- ### Remote URLs (with automatic naming)
- ```bash
- npx install-mcp https://mcp.example.com/server --client claude-desktop
- ```
- The tool automatically:
- - Converts simple package names to `npx package-name`
- - Preserves full commands as-is
- - Infers server names from package names or URLs (e.g., `mcp.example.com` → `mcp-example-com`)
- - Handles OAuth authentication for remote servers
- ### Supermemory project support
- When installing a server hosted on `https://api.supermemory.ai/*`, you can pass a project name via `--project`. This is a convenience alias for adding the header `x-sm-project: <value>`.
- Rules:
- - Only applies to URL installs targeting `https://api.supermemory.ai/*`.
- - Values must not contain spaces.
- - If you omit `--project` for these URLs, you'll be prompted. Pressing Enter uses `default`.
- - The value is injected as a header alongside any `--header` flags.
- Examples:
- ```bash
- # Explicit project
- npx install-mcp https://api.supermemory.ai/servers/my-server \
- --client cursor \
- --project myproj
- # Prompted for project (Enter defaults to "default")
- npx install-mcp https://api.supermemory.ai/servers/my-server --client cursor
- ```
- Warp users: the generated config will include `--header "x-sm-project: <value>"` in the `args` array when installing Supermemory URLs.
- ### Headers Support
- You can pass headers for authentication or other purposes using the `--header` flag:
- ```bash
- # Single header
- npx install-mcp https://api.example.com/mcp --client claude-desktop --header "Authorization: Bearer token123"
- # Multiple headers
- npx install-mcp https://api.example.com/mcp --client claude-desktop \
- --header "Authorization: Bearer token123" \
- --header "X-API-Key: secret-key"
- ```
- ### OAuth Authentication for Remote Servers
- When installing remote servers (URLs), the CLI will ask if the server uses OAuth authentication:
- ```bash
- npx install-mcp https://api.example.com/mcp --client claude-desktop
- # Output: Does this server use OAuth authentication? (Y/n)
- ```
- You can bypass this prompt using the `--oauth` flag:
- ```bash
- # Automatically run OAuth authentication
- npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth yes
- # Skip OAuth authentication entirely
- npx install-mcp https://api.example.com/mcp --client claude-desktop --oauth no
- ```
- If you answer yes, the authentication flow:
- - Runs automatically before installation
- - Handles OAuth flows seamlessly in the background
- - **Authentication state is shared globally** - once you authenticate with a server, that authentication is automatically available to all MCP clients
- - No need to re-authenticate when using the same server in different clients
- ```bash
- # Output: Running authentication for https://api.example.com/mcp
- ```
- If authentication fails, you'll see:
- ```
- Authentication failed. Use the client to authenticate.
- ```
- If the server doesn't use OAuth (you answer no), the installation proceeds directly without authentication.
- This ensures secure access to remote servers while maintaining flexibility for servers that don't require OAuth.
- ## Supported Clients
- The `--client` flag specifies which MCP client you're installing for:
- - `claude-desktop`
- - `cline`
- - `roo-cline`
- - `windsurf`
- - `witsy`
- - `enconvo`
- - `cursor`
- - `vscode`
- - `gemini-cli`
- - `claude-code`
- - `goose`
- - `zed`
- - `opencode`
- - `warp` (outputs config to copy/paste into Warp's cloud-based settings)
- - `codex` (OpenAI's Codex CLI tool)
- - `droid` (Factory.AI's Droid CLI tool)
- - `aider` (AI pair programming tool)
- - `aider-desk` (Desktop version of aider)
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.