Skip to content
Back to search

mcpick

Vendor-neutral MCP configuration manager — one CLI to add, toggle, and audit MCP servers and skills across every AI client, with safety built in

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/spences10/mcpick with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/spences10/mcpick'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spences10--mcpick/badge.svg)](/listings/spences10--mcpick)

HTML

<a href="/listings/spences10--mcpick"><img src="/api/listings/spences10--mcpick/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install -g mcpick
# or run without installing
npx mcpick --help

Requirements:

- Node.js 22+ - Claude Code is required only for Claude Code-specific commands - The GitHub CLI (`gh`, authenticated) is required for portable skills commands; [check-skills](https://github.com/spences10/check-skills) validates skills before install when available

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 · 286 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCPick
  2. [![built with vite+](https://img.shields.io/badge/built%20with-Vite+-646CFF?logo=vite&logoColor=white)](https://viteplus.dev)
  3. [![tested with vitest](https://img.shields.io/badge/tested%20with-Vitest-6E9F18?logo=vitest&logoColor=white)](https://vitest.dev)
  4. Vendor-neutral MCP configuration manager with first-class Claude Code
  5. support.
  6. MCPick helps humans and LLM agents inspect, toggle, and back up MCP
  7. server configuration across multiple AI clients. Claude Code-specific
  8. plugins, hooks, marketplaces, and cache commands remain available, but
  9. they are no longer the core product model.
  10. ## Install
  11. ```bash
  12. npm install -g mcpick
  13. # or run without installing
  14. npx mcpick --help
  15. ```
  16. Requirements:
  17. - Node.js 22+
  18. - Claude Code is required only for Claude Code-specific commands
  19. - The GitHub CLI (`gh`, authenticated) is required for portable skills
  20. commands; [check-skills](https://github.com/spences10/check-skills)
  21. validates skills before install when available
  22. ## Agent-first CLI
  23. In non-TTY environments, MCPick shows help instead of launching the
  24. interactive TUI. This makes it safer for prompts like:
  25. > “Use mcpick to work out how to enable this MCP server.”
  26. Start with:
  27. ```bash
  28. npx mcpick --help
  29. npx mcpick clients
  30. npx mcpick list --json
  31. ```
  32. MCPick redacts known secret patterns before printing output. MCP
  33. configs often contain env vars and authorization headers, so `env` and
  34. `headers` values are shown as `***` in JSON output.
  35. ## MCP server mode
  36. `npx mcpick serve` runs MCPick itself as an MCP server over stdio, so
  37. agents can manage MCP configuration through tool calls instead of
  38. shelling out to the CLI. Tools:
  39. - Read: `mcpick_list`, `mcpick_clients`, `mcpick_get`, `mcpick_doctor`
  40. - Mutate: `mcpick_enable`, `mcpick_disable`, `mcpick_remove`,
  41. `mcpick_add`, `mcpick_add_json`
  42. Read-only/destructive annotations are set so clients can make safe
  43. decisions; secret warnings and `from_env` resolution behave the same
  44. as the CLI. Client config example:
  45. ```json
  46. {
  47. "mcpServers": {
  48. "mcpick": {
  49. "command": "npx",
  50. "args": ["-y", "mcpick", "serve"]
  51. }
  52. }
  53. }
  54. ```
  55. ## MCP clients
  56. Supported client adapters:
  57. | Client | Scopes | Command examples |
  58. | --------------------- | -------------------- | ------------------------------------------------- |
  59. | Claude Code | local, project, user | `mcpick list`, `mcpick enable <server>` |
  60. | Claude Desktop | user | `mcpick list --client claude-desktop` |
  61. | Codex CLI | user | `mcpick list --client codex` |
  62. | Gemini CLI | project, user | `mcpick list --client gemini-cli --scope project` |
  63. | VS Code / Copilot | project | `mcpick list --client vscode --scope project` |
  64. | Cursor | project, user | `mcpick list --client cursor --scope user` |
  65. | Windsurf | user | `mcpick list --client windsurf --scope user` |
  66. | OpenCode | project, user | `mcpick list --client opencode --scope project` |
  67. | Pi via pi-mcp-adapter | project, user | `mcpick list --client pi --scope user` |
  68. Show known config locations:
  69. ```bash
  70. npx mcpick clients
  71. npx mcpick clients --json
  72. ```
  73. ## MCP server commands
  74. ```bash
  75. # List Claude Code registry/status
  76. npx mcpick list
  77. npx mcpick list --json
  78. # List another client
  79. npx mcpick list --client pi --scope user --json
  80. npx mcpick list --client opencode --scope project
  81. # Claude Code enable/disable
  82. npx mcpick enable <server> --scope local
  83. npx mcpick disable <server> --scope local
  84. # Add/remove Claude Code server definitions
  85. npx mcpick add --name <server> --command npx --args "-y,package-name"
  86. npx mcpick add --from-registry io.github.user/server
  87. npx mcpick add-json <name> '{"command":"npx","args":["-y","package-name"]}'
  88. npx mcpick remove <server>
  89. ```
  90. `add --from-registry` requires an exact official MCP Registry name and
  91. writes the package's exact published version. It currently supports
  92. npm packages using stdio; unsupported package types fail without
  93. writing a guessed configuration. Registry-declared required
  94. environment variables must be supplied with `--from-env` or `--env`.
  95. `--dry-run` works for adapter-backed clients.
  96. MCPick warns when a value you write looks like a secret, redacts
  97. printed output, and `npx mcpick doctor` flags plaintext secrets
  98. already on disk. To keep secrets off the command line and out of LLM
  99. conversation context, resolve them from the process environment:
  100. ```bash
  101. pnpx nopeek run .env --only GITHUB_TOKEN -- npx mcpick add --name github --command npx --args "-y,@modelcontextprotocol/server-github" --from-env GITHUB_TOKEN --yes
  102. ```
  103. MCP client config files may still store secrets in plain text because
  104. that is how many clients currently load MCP credentials; prefer
  105. `${VAR}` references where your client supports them.
  106. ## Validate your setup
  107. `npx mcpick doctor` checks every known client config: JSON validity,
  108. per-client schema shape, missing commands on PATH, duplicate servers
  109. across scopes, plaintext secrets, and unpinned server packages. It
  110. exits non-zero when it finds errors, so it works in CI:
  111. ```bash
  112. npx mcpick doctor
  113. npx mcpick doctor --client cursor --json
  114. ```
  115. ## Portable skills
  116. MCPick installs portable SKILL.md packs through the GitHub CLI's
  117. `gh skill` commands. Installs are staged in a temporary directory and
  118. validated with check-skills before anything is written to your agent
  119. directories, and each install records provenance (source repo, pinned
  120. ref, target agents) shown in `skills list --json`.
  121. ```bash
  122. # List installed skills for a client
  123. npx mcpick skills list --agent pi --json
  124. # Search GitHub, or see what a source offers without installing
  125. npx mcpick skills search svelte
  126. npx mcpick skills add spences10/skills --list
  127. npx mcpick skills preview spences10/skills svelte-runes
  128. # Install one skill, pinned for reproducibility
  129. npx mcpick skills add spences10/skills --agent pi --skill svelte-runes --pin v1.2.0 --yes
  130. # Install all skills from a repo at user scope
  131. npx mcpick skills add spences10/skills --agent opencode --all --global --yes
  132. # Check for updates, then apply them
  133. npx mcpick skills update --dry-run --json
  134. npx mcpick skills update
  135. ```
  136. `skills remove` is not supported by the `gh skill` backend; it reports
  137. the manual deletion paths instead.
  138. ## Claude Code-specific tools
  139. These commands wrap Claude Code concepts and are intentionally
  140. client-specific:
  141. ```bash
  142. # Plugins
  143. npx mcpick plugins list
  144. npx mcpick plugins install <name>@<marketplace>
  145. npx mcpick plugins enable <name>@<marketplace>
  146. npx mcpick plugins disable <name>@<marketplace>
  147. # Marketplaces
  148. npx mcpick marketplace list
  149. npx mcpick marketplace add <source>
  150. npx mcpick marketplace update
  151. npx mcpick marketplace remove <name>
  152. # Hooks and plugin cache
  153. npx mcpick hooks list
  154. npx mcpick cache status
  155. npx mcpick cache refresh
  156. ```
  157. ## Profiles and backups
  158. Profiles are portable MCP server snapshots. Claude Code plugin state
  159. is preserved as optional Claude-specific profile metadata.
  160. ```bash
  161. # Legacy Claude Code shortcuts still work
  162. npx mcpick --profile database
  163. npx mcpick --save-profile mysetup
  164. npx mcpick --list-profiles
  165. # Save/load profiles for a specific MCP client
  166. npx mcpick profile save work --client vscode --scope project
  167. npx mcpick profile load work --client opencode --scope project
  168. npx mcpick profile load work --client pi --scope user
  169. npx mcpick backup
  170. npx mcpick restore [file]
  171. # Safe-write rollback backups created before config mutations
  172. npx mcpick rollback --list
  173. npx mcpick rollback [file]
  174. ```
  175. ## Interactive TUI
  176. Running `npx mcpick` in a terminal launches the human-facing menu:
  177. ```text
  178. MCPick - MCP Configuration Manager
  179. What would you like to do?
  180. Enable / Disable MCP servers
  181. Validate configs (doctor)
  182. Skills
  183. Client-specific tools
  184. Load profile
  185. Save profile
  186. Backup config
  187. Restore from backup
  188. Exit
  189. ```
  190. The primary TUI flow is client-first: choose a client, then toggle its
  191. MCP servers. Claude Code plugins, hooks, marketplaces, and cache live
  192. under “Client-specific tools”. “Validate configs (doctor)” runs the
  193. same read-only health checks as `mcpick doctor` (config parse errors,
  194. schema-shape issues, missing commands, duplicate servers, plaintext
  195. secrets, unpinned servers) and prints the report grouped by client.
  196. ## Config locations
  197. MCPick reads the standard locations used by each client adapter.
  198. Common paths include:
  199. | Path | Purpose |
  200. | ------------------------ | ----------------------------------------------- |
  201. | `~/.claude.json` | Claude Code local/user MCP config |
  202. | `.mcp.json` | Shared project MCP config |
  203. | `.gemini/settings.json` | Gemini CLI project config |
  204. | `.vscode/mcp.json` | VS Code / Copilot project config |
  205. | `.cursor/mcp.json` | Cursor project config |
  206. | `opencode.json` | OpenCode project config |
  207. | `~/.config/mcp/mcp.json` | Shared global MCP config used by pi-mcp-adapter |
  208. | `.pi/mcp.json` | Pi project override |
  209. MCPick-owned state lives under `$XDG_CONFIG_HOME/mcpick/`
  210. (`~/.config/mcpick/` by default; override with `MCPICK_CONFIG_DIR`).
  211. State previously kept in `~/.claude/mcpick/` is moved there
  212. automatically on first run.
  213. ## Development
  214. ```bash
  215. pnpm install
  216. pnpm test
  217. pnpm run check
  218. pnpm build
  219. ```
  220. See `docs/VENDOR_NEUTRAL_ARCHITECTURE.md` for architecture notes.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.