# Install mcpm with Homebrew

Open source, community-driven MCP server and client manager. Version 2.15.0 via Homebrew; verified 2026-06-21.

## Install

```sh
sudo av install brew:mcpm
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mcpm
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:mcpm
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mcpm>
- **Version:** 2.15.0
- **Source summary:** Open source, community-driven MCP server and client manager
- **Homepage:** <https://mcpm.sh/>
- **Repository:** <https://github.com/pathintegral-institute/mcpm.sh>
- **Upstream docs:** <https://github.com/pathintegral-institute/mcpm.sh/blob/main/llm.txt>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/8d/e5/ee958c0ef1ab7f7a7e147217e54715358464f0865b35c34502b8cc82869e/mcpm-2.15.0.tar.gz>
- **Last updated:** 2026-06-21T11:15:22Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- mcpm (cli)
- mcpm (alias)

## Dependencies

- certifi
- cryptography
- libyaml
- pydantic
- python@3.14
- rpds-py

## Build dependencies

- cmake
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.15.0
- Package-manager updated: 2026-06-21
- Local data: ok
- Upstream repository: https://mcpm.sh/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

MCPM is an open-source manager and registry-oriented CLI for Model Context Protocol servers. It treats MCP servers as things users can discover, install, organize into profiles, run directly, expose over HTTP, and wire into multiple MCP clients.

### Project history

The public GitHub repository was created in March 2025 by Path Integral Institute. The official README calls the project MCPM - Model Context Protocol Manager and describes it as an open-source CLI that provides a simplified global configuration approach for MCP servers.

The project moved from an earlier target-based model to a v2.0 global workspace model. Its README says MCPM v2.0 installs servers once, organizes them with profiles, integrates them into clients, and includes a central registry for discovering available MCP servers.

### Adoption history

By July 2026, the repository had just under 1k GitHub stars and more than 100 forks. Its official website markets it as a modern MCP server manager and says it works with any MCP client by configuring servers to use `mcpm run server-name`.

The supported-client list on the website and README includes Claude Desktop, Claude Code, Cursor, Windsurf, VSCode, Continue, Cline, Roo Code, OpenCode, Goose CLI, Gemini CLI, Codex CLI, and others. That breadth is the project's adoption pitch: one package-manager-like layer spanning many MCP consumers.

### How it is used

The core package workflow is package-manager-shaped: `mcpm search`, `mcpm install SERVER_NAME`, `mcpm ls`, `mcpm update`, and `mcpm uninstall`. Users can also create profiles, run all servers in a profile, share servers through tunnels, import client configurations, and edit client integrations.

The README documents non-interactive environment variables such as `MCPM_NON_INTERACTIVE`, `MCPM_FORCE`, and `MCPM_JSON_OUTPUT`, plus an `llm.txt` guide intended for AI agents. That makes MCPM notable as both a human CLI and an automation surface for agents managing their own MCP server environment.

### Why package nerds care

MCPM is package-nerd significant because it explicitly imports package-manager concepts into MCP: a registry, install/uninstall commands, global state, update checks, profiles, and client adapters. It exists because installing MCP servers by hand in every client config quickly becomes repetitive.

It also illustrates the MCP ecosystem's registry problem. As MCP servers multiplied, a dedicated manager became useful not just for installation, but for knowing which client configs point to which server definitions and for keeping those definitions portable across tools.

### Timeline

- 2025-03: Public GitHub repository created.
- 2025-03: v1.0.1 release published.
- 2025-2026: Project documents a v2.0 global workspace model replacing earlier target-based configuration.
- 2026-05: v2.15.0 release published.

### Related projects

- MCPM is related to MCP clients such as Claude Desktop, Claude Code, Cursor, Gemini CLI, Codex CLI, and Goose. Within MCP package tooling it complements mcptools, which inspects and calls MCP servers, and MCPHost, which hosts model interactions with configured MCP tools.

### Sources

- <https://api.github.com/repos/pathintegral-institute/mcpm.sh>
- <https://api.github.com/repos/pathintegral-institute/mcpm.sh/releases>
- <https://github.com/pathintegral-institute/mcpm.sh>
- <https://mcpm.sh/>


## Security Notes

No matching local secret-handling manifest was found for mcpm. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mcpm
- **Version Scheme:** 0
- **Revision:** 2
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family.
- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [mcphost](https://www.automicvault.com/pkg/brew/mcphost/) - Shares av.db curated category or tags: ai, ai-tools, cli, developer-tools, mcp.
- [neo4j-mcp](https://www.automicvault.com/pkg/brew/neo4j-mcp/) - Shares av.db curated category or tags: ai, ai-tools, cli, developer-tools, mcp.
- [mcptools](https://www.automicvault.com/pkg/brew/mcptools/) - Shares av.db curated category or tags: ai, cli, developer-tools, mcp.
- [slack-mcp-server](https://www.automicvault.com/pkg/brew/slack-mcp-server/) - Shares av.db curated category or tags: ai, cli, developer-tools, mcp.
- [gitea-mcp-server](https://www.automicvault.com/pkg/brew/gitea-mcp-server/) - Shares av.db curated category or tags: ai, ai-tools, cli, developer-tools, mcp.
- [github-mcp-server](https://www.automicvault.com/pkg/brew/github-mcp-server/) - Shares av.db curated category or tags: ai, ai-tools, cli, developer-tools, mcp.
- [hyper-mcp](https://www.automicvault.com/pkg/brew/hyper-mcp/) - Shares av.db curated category or tags: ai, cli, developer-tools, mcp.
- [mcp-atlassian](https://www.automicvault.com/pkg/brew/mcp-atlassian/) - Shares av.db curated category or tags: ai, ai-tools, cli, developer-tools, mcp.
- [oterm](https://www.automicvault.com/pkg/brew/oterm/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, certifi, cli, client, cryptography.
- [gptme](https://www.automicvault.com/pkg/brew/gptme/) - Both packages touch the same language runtime or ecosystem. Shared terms: ai, certifi, cli, cryptography, developer.

## Combined YAML source

View the package source record on GitHub. [combined/mcpm.yml](https://github.com/automic-vault/db/blob/main/combined/mcpm.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
