OpenMetadata
OpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
What is OpenMetadata?
OpenMetadata is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to openmetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team colla...
OpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- OpenMetadata is a unified metadata platform for data discove
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @us-all/openmetadata-mcpManual Installation
npx -y @us-all/openmetadata-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use OpenMetadata
The OpenMetadata MCP server bridges AI assistants with OpenMetadata's unified metadata platform, exposing 172 tools across 10 categories for data discovery, lineage analysis, governance, and quality management through natural language. Connecting to a live OpenMetadata instance via JWT authentication, it enables data teams to ask questions like 'what dashboards depend on this table?' or 'show me all failing data quality tests' and get structured answers backed by the real metadata catalog. Engineers, data stewards, and analysts can use it to investigate data lineage, bootstrap glossaries, and manage data assets without leaving their AI-assisted workflow.
Prerequisites
- A running OpenMetadata instance (self-hosted or OpenMetadata Cloud) at a reachable URL such as http://localhost:8585
- A bot JWT token from OpenMetadata (Settings → Bots → Create Bot → copy the JWT token)
- Node.js 18 or higher with npx available
- An MCP-compatible client such as Claude Desktop or Claude Code
- OPENMETADATA_ALLOW_WRITE=true (optional) if you want to create or update metadata entities
Set up your OpenMetadata bot token
Log in to your OpenMetadata instance, navigate to Settings → Bots, and create a new service bot. Copy the generated JWT token — this is your OPENMETADATA_TOKEN.
Add the MCP server via Claude Code CLI
The fastest way to register the server is with the claude mcp add command, which sets the environment variables and config in one step.
claude mcp add openmetadata -s user \
-e OPENMETADATA_HOST=http://your-host:8585 \
-e OPENMETADATA_TOKEN=<jwt-bot-token> \
-- npx -y @us-all/openmetadata-mcpOr configure manually in claude_desktop_config.json
Alternatively, add the server block directly to your MCP client configuration file with the required environment variables.
Enable write access (optional)
By default the server is read-only. Set OPENMETADATA_ALLOW_WRITE=true to enable create, update, and delete operations on metadata entities.
export OPENMETADATA_ALLOW_WRITE=trueRestrict tool categories (optional)
Use OM_TOOLS to allowlist only the tool categories you need (e.g., search,core,governance), reducing the tool surface exposed to the AI.
export OM_TOOLS=search,core,governanceTest the connection
Ask your AI assistant to search for a known table or list data assets. A successful response confirms the server is authenticated and communicating with your OpenMetadata instance.
OpenMetadata Examples
Client configuration
Add this block to your claude_desktop_config.json, replacing the host URL and token with your actual OpenMetadata instance values.
{
"mcpServers": {
"openmetadata": {
"command": "npx",
"args": ["-y", "@us-all/openmetadata-mcp"],
"env": {
"OPENMETADATA_HOST": "http://localhost:8585",
"OPENMETADATA_TOKEN": "your-jwt-bot-token",
"OPENMETADATA_ALLOW_WRITE": "false",
"OM_TOOLS": "search,core,governance,lineage"
}
}
}
}Prompts to try
Use these prompts with Claude after connecting to OpenMetadata to explore your data catalog.
- "The payments.transactions table is being deprecated. List every dashboard, pipeline, and ML model that depends on it."
- "Show all failing data quality test cases from the last 7 days, grouped by table and test type."
- "Search for all tables related to 'customer orders' in our data catalog."
- "Create a payments glossary with these 8 terms and link related ones automatically."
- "What is the full upstream lineage for the 'revenue_report' dashboard?"Troubleshooting OpenMetadata
Authentication fails with 401 Unauthorized
Verify that OPENMETADATA_TOKEN is a valid, non-expired JWT from a service bot (not a user token). In OpenMetadata, go to Settings → Bots and regenerate the token if needed. Bot tokens may have expiry settings configured by your admin.
Server connects but returns no data for searches
Check that OPENMETADATA_HOST points to the correct URL including port. Test with curl: `curl -H 'Authorization: Bearer <token>' http://your-host:8585/api/v1/tables` to confirm connectivity independently of the MCP server.
Write operations fail even with OPENMETADATA_ALLOW_WRITE=true
The bot account must have write permissions in OpenMetadata's policy settings. Ask your OpenMetadata admin to grant the bot account the required roles (e.g., Data Steward) for the entity types you want to modify.
Frequently Asked Questions about OpenMetadata
What is OpenMetadata?
OpenMetadata is a Model Context Protocol (MCP) server that openmetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install OpenMetadata?
Install via npm with the command: npx -y @us-all/openmetadata-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with OpenMetadata?
OpenMetadata works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is OpenMetadata free to use?
Yes, OpenMetadata is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
OpenMetadata Alternatives — Similar Analytics Servers
Looking for alternatives to OpenMetadata? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
AI Treasure Box
★ 806🤖 Automatically collected AI repos, tools, websites, papers & tutorials. 实用AI百宝箱 💎
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up OpenMetadata in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use OpenMetadata?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.