Repolode
supermemoryai

supermemoryai/install-mcp

A CLI that installs MCP servers into popular AI clients like Claude Desktop, Cursor, and VS Code, including OAuth auth for remote servers.

Stars
195
Forks
35
Open issues
5
Last commit
20 days ago

What is it?

install-mcp is a command-line tool for adding Model Context Protocol (MCP) servers to AI clients without manually editing each client's configuration file. You pass it a package name, a full command, or a remote URL, along with a target client, and it writes the correct config entry for that client.

It supports npm package names (converted to npx invocations), scoped packages, and custom commands with arguments. For remote URLs it infers a server name from the host, accepts custom headers, and can run an OAuth flow before installation. Authentication state is shared across clients, so a server authenticated once can be used from several of them.

The tool covers a broad set of clients, including Claude Desktop, Cursor, VS Code, Windsurf, Cline, Zed, Goose, Gemini CLI, Claude Code, and Codex. It also includes a convenience option for Supermemory-hosted servers that sets a project header.

Key features

  • 01Accepts package names, scoped packages, full commands, or remote URLs as install targets.
  • 02Writes server configuration for many MCP clients, selected with a --client flag.
  • 03Runs OAuth authentication for remote servers, with the option to skip or pre-answer the prompt.
  • 04Shares authentication state globally across clients.
  • 05Accepts custom headers for remote servers via --header.

Use cases

  • Quickly adding a new MCP server to Claude Desktop or Cursor without editing JSON config by hand.
  • Setting up the same remote MCP server across several AI coding clients at once.
  • Installing an MCP server that requires an API key or OAuth login.

Quick start

  1. 1

    Install and configure an MCP server for your client using npx

    npx install-mcp mcp-package-name --client claude-desktop
  2. 2

    Install a scoped MCP package for a specific client

    npx install-mcp @org/mcp-server --client claude-desktop

Things to know

  • Installs only into clients it supports; the README lists 18 client names.
  • Remote OAuth flows and Supermemory-specific options may need a browser or manual setup.

Topics

FAQ

What is install-mcp?
A CLI that installs MCP servers into popular AI clients like Claude Desktop, Cursor, and VS Code, including OAuth auth for remote servers. install-mcp is a command-line tool for adding Model Context Protocol (MCP) servers to AI clients without manually editing each client's configuration file. You pass it a package name, a full command, or a remote URL, along with a target client, and it writes the correct config entry for that client.
Is install-mcp free to use? What license does it have?
install-mcp is open source under the MIT license. Check the license terms before using it in commercial products.
Is install-mcp still maintained?
Actively maintained. The last commit to install-mcp was on Oct 2, 2026.
What can I use install-mcp for?
Quickly adding a new MCP server to Claude Desktop or Cursor without editing JSON config by hand. Setting up the same remote MCP server across several AI coding clients at once. Installing an MCP server that requires an API key or OAuth login.
How do I install install-mcp?
Install and configure an MCP server for your client using npx: npx install-mcp mcp-package-name --client claude-desktop Install a scoped MCP package for a specific client: npx install-mcp @org/mcp-server --client claude-desktop
Where can I get install-mcp?
The source code and installation instructions are on GitHub: https://github.com/supermemoryai/install-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects