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

# Goose

# Goose Integration

Goose is an open-source AI coding assistant by Block with built-in MCP support. It runs as a CLI or desktop app and connects to MCP servers through its extensions system.

## Prerequisites

* Goose installed ([goose.block.xyz](https://block.github.io/goose/))
* Cognee MCP server running (see [Quickstart](/cognee-mcp/mcp-quickstart) or [Local Setup](/cognee-mcp/mcp-local-setup))
* OpenAI API key (for Cognee's LLM operations)

## Setup Steps

<Steps>
  <Step title="Open the Goose configuration file">
    Goose stores its configuration at `~/.config/goose/config.yaml`. Create the file if it does not exist:

    ```bash theme={null}
    mkdir -p ~/.config/goose
    touch ~/.config/goose/config.yaml
    ```
  </Step>

  <Step title="Add the Cognee extension">
    Choose the configuration that matches how you started the Cognee MCP server:

    <Tabs>
      <Tab title="Docker (HTTP)">
        Use this if you started the server with Docker:

        ```yaml theme={null}
        extensions:
          cognee:
            name: cognee
            type: sse
            uri: http://localhost:8000/mcp
            enabled: true
        ```
      </Tab>

      <Tab title="Local (stdio)">
        Use this if you cloned the repository and run from source:

        ```yaml theme={null}
        extensions:
          cognee:
            name: cognee
            type: stdio
            cmd: uv
            args:
              - --directory
              - /absolute/path/to/cognee-mcp
              - run
              - cognee-mcp
            env:
              LLM_API_KEY: your-openai-key
            enabled: true
        ```

        Replace:

        * `/absolute/path/to/cognee-mcp` with the path to your local cognee-mcp directory
        * `your-openai-key` with your OpenAI API key
      </Tab>
    </Tabs>
  </Step>

  <Step title="Start Goose">
    ```bash theme={null}
    goose session
    ```

    Goose will load the Cognee extension on startup. You can verify it is active by running `/tools` inside the session — Cognee tools should appear in the list.
  </Step>

  <Step title="Use Cognee Tools">
    Goose will invoke Cognee tools automatically when relevant. You can also ask explicitly:

    * "Remember this file in Cognee"
    * "Recall authentication patterns from Cognee"
    * "Improve the current Cognee dataset"
  </Step>
</Steps>

## Where to Use This Configuration

The `~/.config/goose/config.yaml` file is the global Goose configuration. Extensions defined here are available in all Goose sessions.

## Need Help?

<Card title="Join Our Community" icon="discord" href="https://discord.gg/m63hxKsp4p">
  Get support and connect with other developers using Cognee MCP.
</Card>