drio
Open app

MCP Connector for Open WebUI

Source

Connect Open WebUI to MCP (Model Context Protocol) servers

Catalog onlyCatalog onlySTDIO

Overview

MCP Connector for Open WebUI is a tool that connects Open WebUI to MCP (Model Context Protocol) servers, enabling users to utilize MCP-compatible AI models directly within the Open WebUI environment.

To use the MCP Connector, install it via GitHub or through the Open WebUI interface, configure your MCP servers in the settings, and enable the function to access the models in the dropdown menu.

  • Connect to multiple MCP servers simultaneously - Support for API key authentication - Automatic model discovery from MCP servers - Support for streaming responses - Robust error handling and timeout management - Debug mode for troubleshooting
  1. Integrating various AI models into Open WebUI for enhanced functionality.
  2. Facilitating seamless communication between Open WebUI and multiple AI model servers.
  3. Enabling developers to test and deploy AI models efficiently within a user-friendly interface.

Add to your AI client

Use these steps to connect MCP Connector for Open WebUI in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "open-webui-mcp-connector-ivanuser": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-open-webui-mcp-connector-ivanuser"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "open-webui-mcp-connector-ivanuser": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-open-webui-mcp-connector-ivanuser"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "open-webui-mcp-connector-ivanuser": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-open-webui-mcp-connector-ivanuser"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "open-webui-mcp-connector-ivanuser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-open-webui-mcp-connector-ivanuser"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "open-webui-mcp-connector-ivanuser": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-open-webui-mcp-connector-ivanuser"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "open-webui-mcp-connector-ivanuser": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-open-webui-mcp-connector-ivanuser"
      ]
    }
  }
}

FAQ

**What is MCP?**

MCP (Model Context Protocol) is a standardized protocol for AI model interactions, similar to the OpenAI API specification.

**How do I install the MCP Connector?**

You can install it from GitHub using pip or directly through the Open WebUI interface.

**What should I do if I encounter connection issues?**

Check your server URL, network connectivity, and consider increasing the connection timeout.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2650,"uuid":"eea9cfbc-849f-46d1-ad49-a7d946cf4e2d","name":"open-webui-mcp-connector","title":"MCP Connector for Open WebUI","description":"Connect Open WebUI to MCP (Model Context Protocol) servers","avatar_url":"https://avatars.githubusercontent.com/u/45743835?v=4","created_at":"2025-03-13T09:21:33.462Z","updated_at":"2025-03-13T09:24:08.260Z","status":"created","author_name":"ivanuser","author_avatar_url":"https://avatars.githubusercontent.com/u/45743835?v=4","tags":"mcp-connector,open-webui,ai-integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/ivanuser/open-webui-mcp-connector","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-10 06:55:12\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools
MCP Connector for Open WebUI — MCP Registry