Skip to content

Goose.md

Latest commit

 

History

History
131 lines (90 loc) · 3.23 KB

Goose.md

File metadata and controls

131 lines (90 loc) · 3.23 KB

Connecting Pieces MCP to Goose

Tool type: Open-source AI agent framework (CLI and desktop) Website: block.github.io/goose Transport support: stdio, SSE, Streamable HTTP

Config File Location

Platform Path
macOS / Linux ~/.config/goose/config.yaml
Windows %APPDATA%\Block\goose\config\config.yaml

YAML Config Format

Goose uses YAML (not JSON) with an extensions top-level key. Environment variables use ${VAR_NAME} syntax (no env: prefix).

Local Setup (SSE)

Recommended when PiecesOS and Goose are on the same machine.

extensions:
  pieces:
    name: Pieces LTM
    type: sse
    url: http://localhost:39300/model_context_protocol/2024-11-05/sse
    enabled: true
    timeout: 30

Local Setup (Streamable HTTP — recommended)

extensions:
  pieces:
    name: Pieces LTM
    type: streamable_http
    url: http://localhost:39300/model_context_protocol/2025-03-26/mcp
    enabled: true
    timeout: 30

Remote Setup (ngrok)

Use this when Goose is running on a different machine from PiecesOS. For setup, see: Connecting to PiecesOS from the Outside World via Ngrok.

extensions:
  pieces:
    name: Pieces LTM
    type: streamable_http
    url: https://YOUR_NGROK_URL.ngrok.app/model_context_protocol/2025-03-26/mcp
    enabled: true
    timeout: 30

Adding via Interactive Wizard

goose configure
  1. Select "Add Extension"
  2. Choose SSE or Streamable HTTP as the provider type
  3. Enter your Pieces URL
  4. Name it "Pieces LTM"

Adding via Deep Link (One-Click)

Open this in a browser to install directly in Goose (update the URL first):

goose://extension/add?name=pieces&type=sse&url=http%3A%2F%2Flocalhost%3A39300%2Fmodel_context_protocol%2F2024-11-05%2Fsse

Temporary Session Extension

To add Pieces for just one session without saving to config:

goose session --with-remote-extension "http://localhost:39300/model_context_protocol/2024-11-05/sse"

Updating

Edit ~/.config/goose/config.yaml, update the url, and start a new Goose session.

Verification

  1. Run goose session to start a new session
  2. Ask: "What tools do you have from Pieces?"
  3. Pieces LTM tools should be listed

Troubleshooting

Issue Solution
Extension not loading Run goose configure and verify the URL
YAML parse error Ensure consistent indentation; YAML is whitespace-sensitive
Connection timeout Ensure PiecesOS is running; check port 39300-39333
Tools not available Restart the Goose session after editing config

Related Guides

  ← Back to All Agent Setup Guides