Back to GigaRAG

Connect an agent

Give an AI tool access to your GigaRAG Workspace, so it can search, read and write your memos while it works.

Goose

The open source agent from Block, in the terminal or its desktop app.

Install in one click

Add to Goose opens the app and adds GigaRAG, then signs in with your GigaRAG account.

Or use the GigaRAG CLI

One command connects Goose and every other AI tool on this machine. Signing in happens in your browser, so no key is written into any config file.

npm install -g gigarag
gigarag login
gigarag connect

Restart Goose afterwards. Nothing here expires, and gigarag connect --remove takes GigaRAG back out of everything it touched.

Sign in with GigaRAG

Connect without a key: Goose opens your browser, you sign in to GigaRAG and pick this workspace.

  1. 1.

    Add GigaRAG without a header

    Use either way below, and Goose signs in with GigaRAG when it connects.

    Config file
    extensions:
  gigarag:
    type: streamable_http
    name: gigarag
    enabled: true
    uri: "https://mcp.gigarag.com/mcp"
    timeout: 300
  2. 2.

    Sign in with your GigaRAG account

    Your browser opens GigaRAG. Pick the workspace to share and approve. No key is stored in the app, and the connection does not expire.

Or set it up by hand

  1. 1.

    Add GigaRAG to your Goose config

    On macOS and Linux the file is ~/.config/goose/config.yaml. On Windows it is %APPDATA%\Block\goose\config\config.yaml. Merge it under extensions if you already have some.

    config.yaml
    extensions:
  gigarag:
    type: streamable_http
    name: gigarag
    enabled: true
    uri: "https://mcp.gigarag.com/mcp"
    headers:
      Authorization: "Bearer <api-key>"
    timeout: 300
  2. 2.

    Restart Goose

Or use the setup wizard

  1. 1.

    Start the configuration wizard

    goose configure
  2. 2.

    Choose Add Extension, then Remote Extension (Streamable HTTP)

    Name it gigarag.

  3. 3.

    Paste this as the URL

    URL
    https://mcp.gigarag.com/mcp
  4. 4.

    Add one custom header

    Name it Authorization, and paste this as its value.

    Authorization
    Bearer <api-key>

Check it worked

Send this once it is connected. An answer drawn from your workspace means the connection is live.

List my GigaRAG buckets.

Written from the official docs: Goose config files, Using extensions