Smithery CLI

Smithery CLI MCP server installer

Catalog onlyCatalog onlySTDIO

Overview

Smithery CLI is a command-line interface tool designed for installing and managing Model Context Protocol (MCP) servers, which is client-agnostic.

To use Smithery CLI, you can run commands through your terminal using the npx @smithery/cli <command> syntax.

List installed servers interactively. - Install and uninstall servers easily. - View server details and inspect installed servers. - Client specification for installations.

Managing multiple MCP servers in a development environment.
Quickly installing and uninstalling servers as needed.
Inspecting server configurations and details for troubleshooting.

Add to your AI client

Use these steps to connect Smithery CLI in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "cli-smithery-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-smithery-ai"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "cli-smithery-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-smithery-ai"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "cli-smithery-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-smithery-ai"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "cli-smithery-ai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-smithery-ai"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cli-smithery-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-smithery-ai"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "cli-smithery-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-smithery-ai"
      ]
    }
  }
}

FAQ

What is the minimum requirement to run Smithery CLI?

NodeJS version 18 or above is required.

How do I see the list of installed servers?

Use the command `npx @smithery/cli installed` to list all installed servers.

Can I specify which client to use when installing a server?

Yes, you can specify the client using the `--client <name>` option during installation.

Developer tools