Mixedbread

Installation & Setup

Prerequisites

Before installing, ensure you have:

  • Node.js version 20.0 or higher
  • Claude Desktop or another MCP-compatible client
  • Mixedbread API key ()

Installation

Install the Mixedbread MCP server globally:

npm install -g @mixedbread/mcp

Claude Desktop Configuration

1. Locate Configuration File

Find your Claude Desktop configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

2. Add Configuration

Edit the configuration file to add both the Mixedbread MCP server and filesystem access:

{
  "mcpServers": {
    "mixedbread": {
      "command": "npx",
      "args": [
        "-y",
        "@mixedbread/mcp"
      ],
      "env": {
        "MXBAI_API_KEY": "your_api_key_here"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/documents"
      ]
    }
  }
}

3. Restart Claude Desktop

After saving the configuration:

  1. Completely quit Claude Desktop (not just close the window)

  2. Start Claude Desktop again

Verification

Test that everything is working by asking Claude:

  • "What MCP tools do you have available?"
  • "List my vector stores"
  • "Create a test vector store called 'demo'"

Updating

Keep your MCP server up to date:

# Check current version
npm list -g @mixedbread/mcp

# Update to latest
npm update -g @mixedbread/mcp
Introduction
The Mixedbread MCP server provides comprehensive vector store capabilities through the Model Context Protocol, enabling AI assistants to interact with your documents and data.
Tools Reference
Complete reference for all tools available in the Mixedbread MCP server, including parameters and usage examples.

Last updated: July 5, 2025