Open Webui MCP Server
Quick Answer & Overview
- 1. Functionality: Open Webui enables AI coding assistants (Claude Desktop, Cursor, VS Code, Zed) to interface with ai & ml capabilities.
- 2. Quick Install: Execute
npx -y open-webuior insert the JSON snippet into your client configuration. - 3. Authentication: Zero authentication required — runs immediately out of the box.
- 4. Protocol Support: Utilizes standard Model Context Protocol (stdio transport) with JSON-RPC 2.0 message validation.
Technical Architecture & System Integration
The Open Webui Model Context Protocol (MCP) server provides a standardized bridge between modern Large Language Model (LLM) agents and external technical infrastructure. By leveraging open MCP protocol primitives, AI assistants like Claude Desktop, Cursor IDE, VS Code (via Cline/Roo Code), and Zed Editor can inspect, query, and execute capabilities provided by Open Webui without custom integration code.
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
This architectural pattern ensures complete sandbox isolation and security: credentials (such as environment keys) remain strictly inside the local client process environment, never leaking into model prompt contexts or external third-party servers.
2. Key Features & Technical Specifications Matrix
Specification Matrix
| Server Name | Open Webui |
| Identifier | open-webui |
| Category | AI & ML |
| Runtime Engine | npm |
| Transport Layer | stdio (Standard I/O) |
| Auth Mechanism | None Required |
| Install Launcher | npx -y open-webui |
| GitHub Stars | 146,034 |
| Publisher Source | community |
| Last Health Check | 8/25/2026 |
Core Capability Matrix
- Native MCP Tools: Exposes discrete tools callable by AI coding assistants during chat or agent execution loops.
- JSON-RPC 2.0 Specs: Complies with standard protocol error handling and bidirectional message formats.
- Multi-Client Compatibility: Pre-validated for Claude Desktop, Cursor IDE, VS Code (Cline), Zed Editor, and Docker containers.
- Zero Setup Friction: Requires no API key credentials for instant execution.
- Automated Tool Discovery: Client hosts dynamically discover parameters and parameter schemas on connection handshake.
3. Multi-Client Installation Matrix & Setup Guides
Copy and paste the exact configuration snippet for your preferred MCP client or editor environment.
Claude Desktop Setup
claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"open-webui": {
"command": "npx",
"args": [
"-y",
"open-webui"
],
"env": {}
}
}
}Cursor IDE Setup
.cursor/mcp.jsonOpen Cursor Settings → Features → MCP Servers or add to workspace root at .cursor/mcp.json.
{
"mcpServers": {
"open-webui": {
"command": "npx",
"args": [
"-y",
"open-webui"
],
"env": {}
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code / Cline Extension
cline_mcp_settings.jsonAdd configuration block to your extension settings file or Roo Code MCP manager.
{
"mcpServers": {
"open-webui": {
"command": "npx",
"args": [
"-y",
"open-webui"
],
"env": {}
}
}
}Zed Editor & Docker Execution
Zed / DockerDocker run snippet for containerized environments:
docker run -i --rm mcp/open-webui:latest
Zed Settings snippet:
{
"context_servers": {
"open-webui": {
"command": {
"path": "npx",
"args": [
"-y",
"open-webui"
],
"env": {}
}
}
}
}Programmatic SDK Integration (TS / Python)
Connect to Open Webui programmatically inside your application.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
// Initialize Open Webui MCP client transport via stdio
const transport = new StdioClientTransport({
command: "npx",
args: ["-y","open-webui"],
});
const client = new Client(
{ name: "open-webui-client", version: "1.0.0" },
{ capabilities: { tools: {}, resources: {}, prompts: {} } }
);
async function connectAndRun() {
await client.connect(transport);
const tools = await client.listTools();
console.log("Connected to Open Webui MCP Server successfully.");
console.log("Available tools:", tools);
}
connectAndRun().catch(console.error);4. Environment Variables & Security Credentials Reference
Configure authorization secrets and operational parameters safely inside your client environment object.
| Variable Name | Required | Type | Default | Purpose & Description |
|---|---|---|---|---|
| LOG_LEVEL | NO | Configuration String | info | Sets output verbosity level for Open Webui stdio log messages (debug, info, warn, error). |
Security & Best Practices Guidance
- Never commit plain-text API secrets or private tokens to public Git repositories.
- Store credentials in environment variable files (
.env.local) or your operating system secret store. - Limit API key scopes to read-only access where write or delete permissions are not strictly required by your workflow.
5. Tool Parameter Schemas & JSON Specs
Detailed function call signatures and input parameter schemas exposed by Open Webui.
open-webui_execute
Primary execution tool for Open Webui. Accepts operations, queries, or command payloads.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | Required | The target operation or action name to perform. |
| query | string | Optional | Search query or input parameter payload string. |
| options | object | Optional | Optional configuration parameters dictionary. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "open-webui_execute",
"arguments": {
"action": "sample_value",
"query": "sample_value",
"options": 123
}
}
}open-webui_get_status
Retrieve status, state, or metadata from Open Webui.
| Parameter | Type | Required | Description |
|---|---|---|---|
| resource_id | string | Optional | Optional resource identifier to query. |
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "open-webui_get_status",
"arguments": {
"resource_id": "sample_value"
}
}
}6. Real-World AI Assistant Usage Prompts
Copy and paste these natural language prompts into Claude Desktop or Cursor to invoke Open Webui tools.
1. Information Retrieval & Status Inspection
Read-Only Query"Use the Open Webui MCP tool to check system status, list active resources, and summarize current configurations."
2. Executing Workflow Action
Action Execution"Call open-webui_execute with action set to search and inspect recent records matching criteria."
3. Multi-Step Automated Automation
Agent Automation"Analyze output from Open Webui, summarize any errors or warnings, and construct a follow-up request to remediate issues."
4. Schema & Parameter Inspection
Introspection"Inspect available tools exposed by Open Webui MCP server and generate a detailed report of supported capabilities."
7. Error Resolution & Troubleshooting Guide
Diagnose and resolve common JSON-RPC protocol error codes and stdio execution failures.
-32600 (Invalid Request)Root Cause: Malformed JSON-RPC payload sent to server
Resolution Action: Verify MCP client payload adheres to JSON-RPC 2.0 specification.
-32601 (Method Not Found)Root Cause: Requested tool or resource method does not exist
Resolution Action: Call list_tools() to inspect supported tool names on this server.
-32602 (Invalid Params)Root Cause: Missing or invalid tool arguments
Resolution Action: Check argument schema parameter data types against Section 5 specs table.
-32603 (Internal Error)Root Cause: Unhandled execution exception inside server process
Resolution Action: Inspect process stderr logs or check API key credentials.
AUTH_KEY_MISSINGRoot Cause: Required environment variable not set in MCP config
Resolution Action: Define required API key under 'env' object in your MCP client JSON configuration.
STDIO_PIPE_CLOSEDRoot Cause: Server process exited prematurely during startup
Resolution Action: Execute install command directly in terminal to review stderr crash logs.
8. Quality Scorecard & Maintenance Audit
Automated validation metrics for open-source health and documentation completeness.
Own or Maintain Open Webui?
Claim this listing to update descriptions, custom installation commands, and feature documentation.
Claim Listing →Similar AI & ML MCP Servers
Agency Agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
Awesome Llm Apps
100+ AI Agent & RAG apps you can actually run — clone, customize, ship.
Gstack
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA
Cc Switch
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io