> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-metadata.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started with Goose Desktop

> Learn how to connect Goose Desktop with MCP Server, create tokens, and enable secure AI-powered access to your data platform.

# Getting Started with Goose Desktop

Configure OpenMetadata's MCP Server to interact with block's AI agent [Goose](https://github.com/block/goose).

## Prerequisites

For this guide, you will need:

* [nvm](https://github.com/nvm-sh/nvm) and npx/node version 22
* OpenMetadata v1.8.0 or later- You can upgrade your version of OpenMetadata with [this guide](https://docs.open-metadata.org/latest/deployment/upgrade)
* [Goose Desktop](https://block.github.io/goose/docs/quickstart/)
* OpenMetadata [MCP Application and Personal Access Token](https://docs.open-metadata.org/v1.12.x/how-to-guides/mcp#installing-mcp-server)

## 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](https://block.github.io/goose/docs/quickstart/#configure-provider) before prompting.

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

<img src="https://mintcdn.com/openmetadata/AdlqT7tGpGl0YynA/public/images/how-to-guides/mcp/goose-settings.jpg?fit=max&auto=format&n=AdlqT7tGpGl0YynA&q=85&s=6e59b5d9308acf830c17a36a85200146" alt="Goose settings" width="3414" height="2134" data-path="public/images/how-to-guides/mcp/goose-settings.jpg" />

* The custom extension should have the following information:
  * *Extension Name* `OpenMetadata`
  * *Command* paste the following command:
    ```
    npx -y mcp-remote <YOUR_OpenMetadata_SERVER>/mcp --auth-server-url=<YOUR_OpenMetadata_SERVER>/mcp --client-id=OpenMetadata --verbose --clean --header Authorization:${AUTH_HEADER}
    ```
    * If you are running [it locally](https://docs.open-metadata.org/latest/quick-start/local-docker-deployment), your command will look like this:
      ```
      npx -y mcp-remote http://localhost:8585/mcp --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 &lt;YOUR_OpenMetadata_PAT&gt;`

<img src="https://mintcdn.com/openmetadata/AdlqT7tGpGl0YynA/public/images/how-to-guides/mcp/goose-mcp-settings.jpg?fit=max&auto=format&n=AdlqT7tGpGl0YynA&q=85&s=c7fae1875c2d5cc6a018e6ee608b1206" alt="Configuring OpenMetadata MCP Server" width="3414" height="2134" data-path="public/images/how-to-guides/mcp/goose-mcp-settings.jpg" />

* Select *Add Extension*

<img src="https://mintcdn.com/openmetadata/AdlqT7tGpGl0YynA/public/images/how-to-guides/mcp/goose-add-extension.jpg?fit=max&auto=format&n=AdlqT7tGpGl0YynA&q=85&s=a68285fca1525f53bc5a70fee41e48f6" alt="Adding extension" width="3412" height="2131" data-path="public/images/how-to-guides/mcp/goose-add-extension.jpg" />

<img src="https://mintcdn.com/openmetadata/AdlqT7tGpGl0YynA/public/images/how-to-guides/mcp/goose-success.jpg?fit=max&auto=format&n=AdlqT7tGpGl0YynA&q=85&s=76e2c36d8a56f4f4b9fc19de3bed4476" alt="OpenMetadata successfully added" width="3413" height="2132" data-path="public/images/how-to-guides/mcp/goose-success.jpg" />

## 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](https://docs.open-metadata.org/latest/connectors).

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?
```

For more sample use cases with MCP please check out [our blog](https://collatedata.medium.com/mcp-sample-uses-in-openmetadata-b7846864f63b)!

### Reach out on Slack!

With MCP, we are finding new ways to use OpenMetadata all the time! Now that you have Claude and OpenMetadata configured to work together, think you've got a great new use case? Show us what you've got in [Slack](https://slack.open-metadata.org/)!