Claude Desktop

Free

Starter

Professional

You can connect Claude Desktop to the Bleemeo MCP server in two ways:

• Configuration file: add the MCP server locally by editing Claude Desktop’s config file. Works with any Claude subscription but requires Node.js (npx) installed on your machine.
• Organization connector: add Bleemeo as a custom connector in your Claude organization. No local dependency is needed and the connector is also available to Claude in the web browser, but it requires organization admin rights and a paid Claude subscription.

Configuration file

Add the following to your Claude Desktop configuration file:

System	File Location
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Note

If you cannot find the configuration file, open Claude Desktop, go to Settings > Developer, and click Edit config. If the file does not exist, create it at the path shown above.

{
  "mcpServers": {
    "Bleemeo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.bleemeo.com/mcp"
      ]
    }
  }
}

Note

Before copying the configuration, make sure Node.js and npm are installed.

Claude Desktop on Windows: If the server appears in the list but never connects (no handshake, tools missing), Claude may be using its built-in Node.js runtime. Set isUsingBuiltInNodeForMcp to false at the root of the same config file so npx uses your installed Node, then restart Claude Desktop:

{
  "isUsingBuiltInNodeForMcp": false,
  "mcpServers": {
    "Bleemeo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.bleemeo.com/mcp"
      ]
    }
  }
}

The first time you use the MCP tools, a login page will open in your browser asking you to authenticate with your Bleemeo account and select the organization you want to use.

After authentication, the MCP server is connected and ready to use.

Organization connector

Note

This method requires a paid Claude subscription and organization admin rights for the initial setup.

Add the connector (organization admin, once)

A Claude organization admin needs to create the custom connector. This only has to be done once per organization.

1. In Claude, open Settings > Organization.
2. Go to Connectors and click Add custom connector.
3. Choose the Web connector type and enter the URL https://mcp.bleemeo.com/mcp.
4. Save the connector.

Connect your account (each user)

Once the connector is available in the organization, each user can enable it from their own settings.

1. Open your personal Settings (not the organization settings).
2. Go to Connectors and click Connect on the Bleemeo connector.
3. A login page opens in your browser asking you to authenticate with your Bleemeo account and select the organization you want to use.

After authentication, the MCP server is connected and ready to use in Claude Desktop and Claude on the web.