Honeydew Semantic Layer

- Discover and explore your warehouse tables, schemas, and semantic model definitions
- Build and maintain your semantic model through natural conversation
- Query your data with natural language from any MCP-compatible assistant
- Search and read the Honeydew documentation

Honeydew exposes the MCP Server API athttps://mcp.honeydew.cloud/mcp

If your organization uses a custom Honeydew hostname, replace the default URL with your tenant hostname. You can find the hostname in the Honeydew UI underSettings > MCP Server.

There are two ways to authenticate with the Honeydew MCP Server:OAuthorHTTP Basic authentication.

Most clients support OAuth authentication. When you first connect, you'll be prompted to:
- Log in with your Honeydew account
- Accept the OAuth authorization

The client then securely provides an access token for subsequent requests.

The MCP Server in HTTP Basic authentication mode requires anAPI Keyfor authentication.

You need to provide a Base64-encoded string of your API Key and API Secret in the formatAPI_KEY:API_SECRET.

If creating a new API Key for MCP Server access, you can copy the Base64-encoded string from the Honeydew Studio UI at the time of creation.

You can use the following command to generate the Base64-encoded string:

You can optionally provide these headers in your MCP server configuration:

- Workspace: Pin the workspace for all requests (optional)
- Branch: Pin a specific workspace branch for all requests (optional, defaults toprodif workspace is set)
- Honeydew-Client: Identify the MCP client (optional, auto-detected from the connected tool). Pass this header to provide a specific client identifier.
- ReadonlyToolsOnly: Set totrueto expose only read-only tools (optional)

Launch Claude Code withclaude, then add the marketplace:

/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

Then install the Honeydew plugin from the marketplace:

/plugin install honeydew-ai@honeydew-ai-claude-plugins

To update the Honeydew marketplace plugins, launch Claude Code withclaude, then:
- Write/pluginand selectMarketplacesin the selector at the top
- Selecthoneydew-ai-coding-agents-plugins
- ClickUpdate marketplace

To receive updates automatically, selectEnable auto-updatein the marketplace settings.

Use this section if your organization uses a custom Honeydew endpoint, or if you prefer to configure the MCP servers without installing the plugin. Disable the Honeydew MCP connection added by the plugin, then add your custom endpoint using the instructions below.

The Honeydew MCP server connects Claude Code to the Honeydew Semantic Layer for model exploration, data querying, model management, and documentation access.

Use one of the following methods to add the Honeydew MCP server:

If your organization uses a custom Honeydew hostname, replacehttps://mcp.honeydew.cloud/mcpwith your tenant hostname. You can find the hostname inSettings > MCP Serverin Honeydew Studio.

Launch Claude Code with claude. You'll be prompted to authenticate with OAuth to Honeydew. </Tab> <Tab title="API Key"> 

Claude Code resolves${VAR_NAME}references at runtime from your environment.

The Honeydew MCP server already includes documentation access tools, so a separate documentation server is not needed. Add the Honeydew Documentation MCP only if you want documentation access without connecting to Honeydew. No authentication is required.

Use this section if your organization uses a custom Honeydew endpoint, or if you prefer to configure the MCP servers without installing the plugin. Disable the Honeydew MCP connection added by the plugin, then add your custom endpoint using the instructions below.

The Honeydew MCP server connects Cortex Code CLI to the Honeydew Semantic Layer for model exploration, data querying, model management, and documentation access.
If your organization uses a custom Honeydew hostname, replacehttps://mcp.honeydew.cloud/mcpwith your tenant hostname. You can find the hostname inSettings > MCP Serverin Honeydew Studio.