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.

Installation

Install the published command into an isolated environment:

pipx install conda-cli-mcp

Keep the server environment separate from the target conda installation and select that installation with --conda-exe.

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:

conda-cli-mcp --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-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:
Newer release available (0.2.0)

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.1.0.tar.gz (145.9 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.1.0-py3-none-any.whl (31.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: conda_cli_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 145.9 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.1.0.tar.gz
Algorithm Hash digest
SHA256 49a623c98c36d85d81f27478e57dd918c1fc46174b927f8f1483b5c9dc38e120
MD5 51ad93477be9efb718ad671ba4986000
BLAKE2b-256 2dec5e52cd3698e9f76e08ba823880d9f60bce58e307ab457530c5335de232e4

See more details on using hashes here.

Provenance

The following attestation bundles were made for conda_cli_mcp-0.1.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.1.0-py3-none-any.whl.

File metadata

  • Download URL: conda_cli_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 31.3 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9c64354b7d84da8535b4a2215b8e071b3dfd30bf6f44d1e3198a46713fe050c1
MD5 adb175a4658e3395ead387257f745778
BLAKE2b-256 cafcfe3fa1a7bf5b116a9c74e23a4a71f4a85a7925314d8e52457ec1f42c12eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for conda_cli_mcp-0.1.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

0.2.0

2 files

This release

0.1.0 This release

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