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)
Cognee MCP server running (see Quickstart or Local Setup)
OpenAI API key (for Cognee’s LLM operations)

Setup Steps

Open the Goose configuration file

Goose stores its configuration at ~/.config/goose/config.yaml. Create the file if it does not exist:

mkdir -p ~/.config/goose
touch ~/.config/goose/config.yaml

Add the Cognee extension

Choose the configuration that matches how you started the Cognee MCP server:

Docker (HTTP)
Local (stdio)

Use this if you started the server with Docker:

extensions:
  cognee:
    name: cognee
    type: sse
    uri: http://localhost:8000/mcp
    enabled: true

Use this if you cloned the repository and run from source:

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

Start Goose

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.

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”

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?

Join Our Community

Get support and connect with other developers using Cognee MCP.

Setup

Integrations

Documentation Index

​Goose Integration

​Prerequisites

​Setup Steps

​Where to Use This Configuration

​Need Help?