conda-cli-mcp

conda-cli-mcp exposes an installed conda command line through the Model Context Protocol. It discovers built-in and plugin-contributed commands at startup, creates structured tools from conda's argparse definitions, and keeps the complete CLI reachable through an explicitly enabled raw argv tool.

The server runs conda in bounded child processes. Conda remains responsible for configuration, plugin ordering, solving, transactions, reporters, authentication, hooks, and error handling.

When conda-completion 0.3 or newer is installed in the target environment, a read-only metadata tool exposes its command-specific completion hints through the plugin's public Python API.

The project is alpha software. It requires Python 3.10 or newer and supports target conda versions >=26.7,<27.

Run the standalone server as ccm. When the package is installed in conda's own environment, conda mcp launches the server against that conda installation without requiring --conda-exe. These launchers require conda-cli-mcp 0.2.0 or newer.

Installation

Install from the jezdez channel on Anaconda.org:

conda create --yes --name conda-cli-mcp --override-channels --channel jezdez --channel conda-forge "conda-cli-mcp>=0.2"
conda activate conda-cli-mcp
ccm --version

Documentation

The documentation is organized by purpose:

Documentation is published at jezdez.github.io/conda-cli-mcp.

Safety

The default policy is read-only. --allow-write permits conda-managed mutations. --allow-exec permits conda run, opaque passthrough arguments, and the raw conda_execute tool. Policy is fixed at startup and enforced before conda starts.

Running the server

Select the target conda executable explicitly when it lives in another environment:

ccm --conda-exe /absolute/path/to/conda

Without --conda-exe, resolution checks CONDA_EXE and then PATH. MCP clients connect over standard input and standard output. See the getting-started tutorial for a client configuration.

Project scope

  • conda-cli-mcp owns local conda CLI discovery and execution.
  • conda-meta-mcp owns read-only package and ecosystem metadata.
  • conda-runtime owns the ready-to-run conda executable and can include this plugin as a locked runtime dependency.
  • conda-mcp is reserved for a future umbrella package that installs both.

Development

Development, documentation, and packaging use Pixi:

pixi install
pixi run test
pixi run check
pixi run -e docs docs
pixi run -e build package

The conda recipe is noarch Python and lives in recipe/recipe.yaml.

Project links

Data verified by PyPI on Aug 22, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for jezdez from gravatar.com jezdez

GitHub Statistics

Data verified by PyPI on Aug 22, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

BSD-3-Clause
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

conda_cli_mcp-0.2.0.tar.gz (150.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

conda_cli_mcp-0.2.0-py3-none-any.whl (32.5 kB view details)

Uploaded Python 3

File details

Details for the file conda_cli_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: conda_cli_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 150.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for conda_cli_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 c20576f55d82ee2ef01ceaf399cebc26a0b87d2c5e4e4a38196a842b0dff4289
MD5 cb90a9be01cefb4057aba3917c92082e
BLAKE2b-256 c9b18a45f2c2fb3eb822b8da15d29e7dfc5d1dba2d75dee1f469e54fe11b1dfc

See more details on using hashes here.

Provenance

The following attestation bundles were made for conda_cli_mcp-0.2.0.tar.gz:

Publisher: release.yml on jezdez/conda-cli-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file conda_cli_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: conda_cli_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 32.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for conda_cli_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f8c05b6990cf9e2890efce3e5a718476fdc50f63cf4d9b28d1b0469cc2f058fb
MD5 5b7afc07caf9843f8893f894110e155f
BLAKE2b-256 b33f5bd8f87f58b5938666956dc6fbf2894f0aa076b35dc507d6f786cdaa2661

See more details on using hashes here.

Provenance

The following attestation bundles were made for conda_cli_mcp-0.2.0-py3-none-any.whl:

Publisher: release.yml on jezdez/conda-cli-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page