> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

export const GCell = ({children, className}) => <div className={`grid-table-cell ${className || ""}`} role="cell">
    {children}
  </div>;

export const GTH = ({children, className}) => <div className={`grid-table-th ${className || ""}`} role="columnheader">
    {children}
  </div>;

export const GRow = ({children}) => <div className="grid-table-row" role="row">{children}</div>;

export const GBody = ({children}) => <div className="grid-table-body" role="rowgroup">{children}</div>;

export const GHead = ({children}) => <div className="grid-table-head" role="rowgroup">{children}</div>;

export const GTable = ({children, className, cols}) => <div className={`grid-table not-prose overflow-hidden rounded-2xl ${className || ""}`} style={{
  "--grid-table-cols": cols
}} role="table">
    {children}
  </div>;

`anaconda-mcp` is a package that exposes conda environment management tools to MCP-enabled AI coding assistants using the `anaconda mcp` commands. It acts as a unified MCP endpoint, giving AI assistants like Claude, Cursor, and VS Code awareness of your conda environments, packages, and channel configurations.

This guide provides an overview of the `anaconda mcp` commands and core concepts. For a walkthrough of how to connect Anaconda MCP to your AI coding assistant automatically using a <Tooltip tip="A graphical interface with images, icons, and menus that lets you interact with software instead of typing commands.">GUI</Tooltip> in Anaconda Desktop, see [Anaconda MCP](/docs/anaconda-desktop/mcp).

## Installation

`anaconda-mcp` is included with Anaconda CLI. [Install Anaconda CLI and run the bootstrap](/docs/cli-reference/anaconda-cli/getting-started) to make `anaconda mcp` commands available.

## Basic usage

### Configure your AI coding assistant

This command launches an interactive wizard to configure your AI coding assistant to use Anaconda MCP Server at a global or project level. Anaconda MCP currently supports the following assistants: Claude Desktop, Claude Code, Cursor, VS Code, Opencode, and Windsurf.

You must be logged in to your anaconda.com account to use Anaconda MCP. If you're not logged in, `anaconda mcp setup` prompts you to log in.

<Note>
  You are prompted to agree to the [Anaconda MCP Beta Agreement](https://www.anaconda.com/legal/terms/mcpbeta) during initial setup.
</Note>

```sh theme={null}
anaconda mcp setup
```

To configure a specific assistant non-interactively, use the `--client` flag:

```sh theme={null}
anaconda mcp setup --client <CLIENT>
```

The following client identifiers are accepted by the `--client` flag:

<GTable cols="34% 33% 33%">
  <GHead>
    <GRow>
      <GTH>Client identifier</GTH>
      <GTH>AI coding assistant</GTH>
      <GTH>Supports project scope</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>`claude-desktop`</GCell>
      <GCell>Claude Desktop</GCell>
      <GCell>No</GCell>
    </GRow>

    <GRow>
      <GCell>`claude-code`</GCell>
      <GCell>Claude Code</GCell>
      <GCell>Yes</GCell>
    </GRow>

    <GRow>
      <GCell>`cursor`</GCell>
      <GCell>Cursor</GCell>
      <GCell>Yes</GCell>
    </GRow>

    <GRow>
      <GCell>`vscode`</GCell>
      <GCell>VS Code</GCell>
      <GCell>Yes</GCell>
    </GRow>

    <GRow>
      <GCell>`opencode`</GCell>
      <GCell>Opencode</GCell>
      <GCell>Yes</GCell>
    </GRow>

    <GRow>
      <GCell>`windsurf`</GCell>
      <GCell>Windsurf</GCell>
      <GCell>No</GCell>
    </GRow>
  </GBody>
</GTable>

### Remove a configuration

This command removes the Anaconda MCP Server configuration for an AI coding assistant. `--client` is required.

```sh theme={null}
anaconda mcp remove --client <CLIENT>
```

### List supported assistants

This command lists all supported AI coding assistants and shows whether Anaconda MCP Server is currently configured for each.

```sh theme={null}
anaconda mcp clients
```

## Capabilities

Once connected, you can manage your conda environments and packages using natural language:

<GTable cols="40% 60%">
  <GHead>
    <GRow>
      <GTH>Capability</GTH>
      <GTH>Natural language prompt example</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>**Create a new environment**</GCell>
      <GCell>"Create a new conda environment named `my-env` with Python 3.10 and numpy."</GCell>
    </GRow>

    <GRow>
      <GCell>**List all environments**</GCell>
      <GCell>"Show all my conda environments."</GCell>
    </GRow>

    <GRow>
      <GCell>**Show environment details**</GCell>
      <GCell>"What packages are installed in the `my-env` environment?"</GCell>
    </GRow>

    <GRow>
      <GCell>**Install, update, or remove packages**</GCell>
      <GCell>"Add pandas and matplotlib to `my-env`."</GCell>
    </GRow>

    <GRow>
      <GCell>**Search for packages**</GCell>
      <GCell>"Find all available versions of scikit-learn."</GCell>
    </GRow>

    <GRow>
      <GCell>**Remove an environment**</GCell>
      <GCell>"Delete the environment called `oldenv`."</GCell>
    </GRow>

    <GRow>
      <GCell>**Search packages on Anaconda.org**</GCell>
      <GCell>"Find me the latest version of `scikit-learn` available on the main channel."</GCell>
    </GRow>

    <GRow>
      <GCell>**Search notebooks and collections on nb.anaconda.com, pyscript.com, and Anaconda Toolbox**</GCell>
      <GCell>"Find my Jupyter notebook on nb.anaconda.com where I built a time series forecasting model so I can reuse that analysis."</GCell>
    </GRow>

    <GRow>
      <GCell>**Search Anaconda documentation**</GCell>
      <GCell>"Search the Anaconda docs to show me how to configure conda to use my organization channel as the only channel I install packages from."</GCell>
    </GRow>

    <GRow>
      <GCell>**Search the Anaconda community forum**</GCell>
      <GCell>"Search the Anaconda forum to see if anyone else has run into CUDA version conflicts when installing PyTorch."</GCell>
    </GRow>
  </GBody>
</GTable>