Install segment-mcp in Goose
What you need first
- Goose, installed.
- uv, which
gives the
uvxcommand the server starts with. - Your own values for
YOUR_SEGMENT_API_TOKEN,YOUR_SEGMENT_REGION.
Steps
- Open
~/.config/goose/config.yaml. On Windows it is%APPDATA%\Block\goose\config\config.yaml. - Add this entry. If the file already has
extensions, add only the entry inside it.
extensions:
"segment-mcp":
type: stdio
name: "segment-mcp"
enabled: true
cmd: "uvx"
args: ["segment-mcp==0.1.2"]
env_keys: []
envs: { "SEGMENT_API_TOKEN": "YOUR_SEGMENT_API_TOKEN", "SEGMENT_REGION": "YOUR_SEGMENT_REGION" }
timeout: 300 - Replace
YOUR_SEGMENT_API_TOKEN,YOUR_SEGMENT_REGIONwith your own values. - Save the file and start a new Goose session.
Check it worked
Ask Goose: List the tools of segment-mcp.
If it does not start
- spawn uvx ENOENT
- uv is not on the PATH that Goose sees. Install it, or write the
full path of
uvxin the config. - The server starts, but its tools fail
- A
YOUR_…placeholder is still in the config, or its value is wrong. - Nothing changes after a restart
- The file is not valid YAML any more. Check that the entry is indented like the lines around it.