OpenMetadata/openmetadata-docs/content/v1.8.x/how-to-guides/mcp/goose.md

title	slug
Getting Started with Goose Desktop	/how-to-guides/mcp/goose

Getting Started with Goose Desktop

Configure OpenMetadata's MCP Server to interact with block's AI agent Goose.

Prerequisites

For this guide, you will need:

• OpenMetadata v1.8.0 - You can upgrade your version of OpenMetadata with this guide
• Goose Desktop

Add MCP App to OpenMetadata

OpenMetadata has a variety of applications to improve your data such as MetaPilot, Data Insights, Search Indexing, and MCP.

• Go to /marketplace/apps/McpApplication and select Install. If your OpenMetadata is installed locally, the url would be:

http://localhost:8585/settings/apps/McpApplication

{% image src="/images/v1.8/how-to-guides/mcp/install-mcp.jpg" alt="Add MCP app" caption="Install MCP Server on OpenMetadata" /%}

• The next screen, with Origin Header URI is for Streamable-Http requests. This guide uses SSE, so we can skip this portion, select Submit

Creating your OpenMetadata Personal Access Token

The next step will be to create a Personal Access Token (PAT) and add it to Goose so your models can communicate with OpenMetadata.

• To create an OpenMetadata Personal Access Token, go to:

 <YOUR-OpenMetadata-SERVER>/users/<YOUR-USERNAME>/access-token

If OpenMetadata is installed locally, it will be:

http://localhost:8585/users/admin/access-token

• Select Generate New Token. This will give your models the same role and access policy that is assigned to you in OpenMetadata. If you would like your models in Goose to have different access controls, create a new user.

{% image src="/images/v1.8/how-to-guides/mcp/generate-new-token.jpg" alt="Generate New Token" caption="Creating a new Personal Access Token" /%}

• Set your Token Expiration. This guide uses 60 days. Once your new token is created copy it.

{% image src="/images/v1.8/how-to-guides/mcp/generate-new-token-2.jpg" alt="Set Token Lifespan" caption="Personal Access Token expires in 60 days" /%}

Adding your OpenMetadata MCP Server to Goose Desktop

This how-to guide uses Goose Desktop for macOS. Make sure that you already have an LLM Provider configured before prompting.

• Navigate to Goose Desktop's Settings, then under Extensions, select +Add custom extension.

{% image src="/images/v1.8/how-to-guides/mcp/goose-settings.jpg" alt="Goose settings" caption="Settings are where you add custom extensions like OpenMetadata MCP Server" /%}

• The custom extension should have the following information:
  • Extension Name OpenMetadata
  • Command paste the following command:

    npx -y mcp-remote <YOUR_OpenMetadata_SERVER>/mcp/sse --auth-server-url=<YOUR_OpenMetadata_SERVER>/mcp --client-id=openmetadata --verbose --clean --header Authorization:${AUTH_HEADER}
    

    • If you are running OpenMetadata locally, your command will look like this:

      npx -y mcp-remote http://localhost:8585/mcp/sse --auth-server-url=http://localhost:8585/mcp --client-id=openmetadata --verbose --clean --header Authorization:${AUTH_HEADER}
      

  • Add 1 Environment Variable
    • Variable name is AUTH_HEADER
    • Value is "Bearer <YOUR_OpenMetadata_PAT>

{% image src="/images/v1.8/how-to-guides/mcp/goose-mcp-settings.jpg" alt="Configuring OpenMetadata MCP Server" caption="The proper settings for OpenMetadata MCP Server in Goose" /%}

- Select *+Add* to store this Environment Variable

{% image src="/images/v1.8/how-to-guides/mcp/goose-mcp-settings.jpg" alt="Configuring OpenMetadata MCP Server" caption="The proper settings for OpenMetadata MCP Server in Goose" /%}

• Select Add Extension

{% image src="/images/v1.8/how-to-guides/mcp/goose-add-extension.jpg" alt="Adding extension" caption="Adding OpenMetadata MCP Server as a custom extension to Goose" /%}

{% image src="/images/v1.8/how-to-guides/mcp/goose-success.jpg" alt="OpenMetadata successfully added" caption="OpenMetadata successfully added to Goose" /%}

Prompt to read from OpenMetadata

This part of the guide assumes that you have assets in OpenMetadata. You can add data assets into OpenMetadata here.

Select a model from Goose and paste the following prompt to have it read from OpenMetadata:

What tables do you have access to in OpenMetadata?

Show us what you got

With MCP, we are finding new ways to use OpenMetadata all the time! Now that you have Goose and OpenMetadata configured to work together, think you've got a great new use case? Show us what you've got in the OpenMetadata #mcp Slack Channel!