Access the W&B MCP Server ↗

    {
      "mcpServers": {
        "wandb": {
          "transport": "http",
          "url": "https://mcp.withwandb.com/mcp",
          "headers": {
            "Authorization": "Bearer <your-wandb-api-key>",
            "Accept": "application/json, text/event-stream"
          }
        }
      }
    }
    ```

5. Restart Cursor to make the changes take effect.
6. Verify that the chat agent has access to the W\&B MCP server by entering the prompt "List the projects in my W\&B account."

For more detailed information, see [Cursor's documentation](https://cursor.com/docs/context/mcp).
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Claude Code"></span>
To add the W\&B MCP server to Claude Code, update the following command's `Authorization` header with your W\&B API key and run it in your terminal:

```bash
    claude mcp add --transport http wandb https://mcp.withwandb.com/mcp \
      --header "Authorization: Bearer <your-wandb-api-key>"
    ```

Add `--scope user` for a global configuration, or omit it to configure for the current project only.

For more detailed information, see [Claude Code's documentation](https://docs.anthropic.com/en/docs/claude-code/mcp).
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Codex"></span>
To add the W\&B MCP server to Codex, update the following command's `--bearer-token-env-var` argument with the environment variable containing your W\&B API key, then run it in your terminal:

```bash
    export WANDB_API_KEY=<your-wandb-api-key>
    codex mcp add wandb --url https://mcp.withwandb.com/mcp --bearer-token-env-var <your-wandb-api-key-environment-variable>
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="OpenAI"></span>
To add the W\&B MCP server to your OpenAI calls, add the server's information to the `tools` field of your OpenAI responses configuration:

```python
    from openai import OpenAI
    import os

    client = OpenAI()

    resp = client.responses.create(
        model="gpt-4o",
        tools=[{
            "type": "mcp",
            "server_label": "wandb",
            "server_description": "Query W&B data",
            "server_url": "https://mcp.withwandb.com/mcp",
            "authorization": os.getenv("<your-wandb-api-key>"),
            "require_approval": "never",
        }],
        input="List the projects in my W&B account.",
    )

    print(resp.output_text)
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Gemini CLI"></span>
To add the W\&B MCP server to Gemini CLI:

1. Install the W\&B MCP extension with a single command:

   ```bash
       # Install the extension
       gemini extensions install https://github.com/wandb/wandb-mcp-server
       ```
2. Once installed, restart the Gemini CLI.
3. Verify that the chat agent has access to the W\&B MCP server by entering the prompt "List the projects in my W\&B account."

For more detailed information, see [Gemini's documentation](https://geminicli.com/docs/tools/mcp-server/).
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Mistral LeChat"></span>
To add the W\&B MCP server to Mistral LeChat:

1. From the **Intelligence** menu, select **Add Connector** to open the Connector window.

2. Select the **Custom MCP Connector** tab.

3. Configure the fields using the following values:

   * **Connector Server**: `https://mcp.withwandb.com/mcp`
   * **Description**: (Optional) A brief arbitrary description of the connection.
   * **Authentication Method**: Select **API Token Authentication**. This opens additional fields.
   * **Header name**: Leave the default value, **Authorization**.
   * **Header type**: Select **Bearer**.
   * **Header value**: Enter your W\&B API token.

4. Once you have configured all the fields, select **Create**. LeChat adds the MCP server to your configuration.

5. Verify that the chat agent has access to the W\&B MCP server by entering the prompt "List the projects in my W\&B account."

For more detailed information, see [LeChat's documentation](https://mistral.ai/news/le-chat-mcp-connectors-memories).
  <span class="tab-end"></span>
<span class="tab-group-end"></span>

## Set up a local version of the W\&B MCP server

If you need to run the MCP server locally for W\&B Self-Managed deployments, development, testing, or air-gapped environments, you can install and run it on your machine.

### Prerequisites

* A W\&B API key. You can create a new one at [wandb.ai/authorize](https://wandb.ai/authorize).
* Set your key as an environment variable named `WANDB_API_KEY`.
* Set the `WANDB_BASE_URL` environment variable if you are using [W\&B Self-Managed](/platform/hosting/hosting-options/self-managed).
* Python 3.10 or higher
* [uv](https://docs.astral.sh/uv/) (recommended) or pip

See uv's docs for [installation instructions](https://docs.astral.sh/uv/getting-started/installation/).

### Install and configure the MCP server

To install the MPC server locally:

To install the W\&B MCP server on your local machine, use one of the following installation commands:

<span class="tab-group-start"></span>
  <span class="tab-start" data-tab-title="uv"></span>
```bash
    uv install wandb-mcp-server
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="pip"></span>
```bash
    pip install wandb-mcp-server
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Install directly from GitHub"></span>
```bash
    pip install git+https://github.com/wandb/wandb-mcp-server
    ```
  <span class="tab-end"></span>
<span class="tab-group-end"></span>

Once you have installed the MCP server locally, configure your MCP client to use it. Select an MCP client to continue:

<span class="tab-group-start"></span>
  <span class="tab-start" data-tab-title="Cursor"></span>
Add the following to your `mcp.json` configuration:

```json
    {
      "mcpServers": {
        "wandb": {
          "command": "uvx",
          "args": [
            "--from",
            "git+https://github.com/wandb/wandb-mcp-server",
            "wandb_mcp_server"
          ],
          "env": {
            "WANDB_API_KEY": "<your-wandb-api-key>",
            "WANDB_BASE_URL": "https://your-wandb-instance.example.com"
          }
        }
      }
    }
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="VS Code"></span>
Add the following to your `.vscode/mcp.json` or global MCP configuration:

```json
    {
      "servers": {
        "wandb": {
          "command": "uvx",
          "args": [
            "--from",
            "git+https://github.com/wandb/wandb-mcp-server",
            "wandb_mcp_server"
          ],
          "env": {
            "WANDB_API_KEY": "<your-wandb-api-key>",
            "WANDB_BASE_URL": "https://your-wandb-instance.example.com"
          }
        }
      }
    }
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Claude Code"></span>
Run the following command in your terminal. Add `--scope user` for a global configuration, or omit it to configure for the current project only.

```bash
    claude mcp add wandb \
      -e WANDB_API_KEY=your-api-key \
      -e WANDB_BASE_URL=https://your-wandb-instance.example.com \
      -- uvx --from git+https://github.com/wandb/wandb-mcp-server wandb_mcp_server
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Codex"></span>
Run the following command in your terminal:

```bash
    codex mcp add wandb \
      --env WANDB_API_KEY=your_api_key_here \
      --env WANDB_BASE_URL=https://your-wandb-instance.example.com \
      -- uvx --from git+https://github.com/wandb/wandb-mcp-server wandb_mcp_server
    ```
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Claude Desktop"></span>
Open your Claude config file in a text editor. You can find the config file at the locations for your OS:

* **macOS**: \~/Library/Application\ Support/Claude/claude\_desktop\_config.json
* **Windows**: %APPDATA%\Claude\claude\_desktop\_config.json

Add the following to your JSON object to your Claude config file. Use the full path to `uvx` because Claude Desktop may not find your `uvx` installation otherwise.

```json
    {
      "mcpServers": {
        "wandb": {
          "command": "/full/path/to/uvx",
          "args": [
            "--from",
            "git+https://github.com/wandb/wandb-mcp-server",
            "wandb_mcp_server"
          ],
          "env": {
            "WANDB_API_KEY": "<your-wandb-api-key>",
            "WANDB_BASE_URL": "https://your-wandb-instance.example.com"
          }
        }
      }
    }
    ```

Restart Claude Desktop to activate the new configuration.
  <span class="tab-end"></span>
<span class="tab-group-end"></span>

For web-based clients or testing, run the server with HTTP transport:

```bash
uvx wandb_mcp_server --transport http --host 0.0.0.0 --port 8080

uvx wandb_mcp_server --transport http --port 8080

# In another terminal, expose with ngrok
ngrok http 8080