Skip to main content
Watch: I Built an AI App Without Leaving Databricks

MCP client - Agentic AI Foundation (AAIF) - verified

How to add an MCP server to goose

Where to add MCP servers in goose: extensions key in ~/.config/goose/config.yaml (macOS/Linux) or %APPDATA%\Block\goose\config\config.yaml (Windows); or goose configure. Its docs list support for stdio and Streamable HTTP and say SSE is not supported. It handles OAuth sign-in for remote servers.

goose homepage - Goose in our tools directory - Compare all MCP clients

Kind
Coding agent
stdio
Yes
Streamable HTTP
Yes
SSE
No

Add a server

Where the config lives
extensions key in ~/.config/goose/config.yaml (macOS/Linux) or %APPDATA%\Block\goose\config\config.yaml (Windows); or goose configure

The example from the goose docs, copied verbatim. Swap in your server's name, command or URL.

YAML
extensions:
  github:
    name: GitHub
    cmd: npx
    args: [-y @modelcontextprotocol/server-github]
    enabled: true
    envs: { "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" }
    type: stdio
    timeout: 300

Source: goose-docs.ai/docs/getting-started/using-extensions

Which server?

Pick a server from the verified directory of official MCP servers. Each one lists its transport, auth and the setup snippets its vendor publishes, so you can match it to what goose supports.

MCP support

What the goose docs say it supports. Not stated means the docs do not say either way.

goose MCP features, transports and OAuth, each with its source
FeatureValueSource
ToolsCalls the functions a server exposes.Yesgoose-docs.ai/docs/tutorials/custom-extensions
ResourcesReads data and files a server exposes as resources.Yesgoose-docs.ai/docs/tutorials/custom-extensions
PromptsOffers a server's prompt templates to the user.Yesgoose-docs.ai/docs/tutorials/custom-extensions
SamplingLets a server ask the client's model for a completion.Nogoose-docs.ai/docs/mcp/council-of-mine-mcp
RootsTells a server which directories it may work in.Yesgoose-docs.ai/docs/guides/mcp-roots
ElicitationLets a server ask the user for input mid-task.Yesgoose-docs.ai/docs/guides/mcp-elicitation
DiscoveryPicks up tools, prompts or resources a server adds or removes while connected.Not statedDocs do not say
InstructionsUses the instructions a server sends when it connects.Not statedDocs do not say
stdioStarts a local server as a subprocess.Yesgoose-docs.ai/docs/guides/config-files
Streamable HTTPConnects to a remote server over the current HTTP transport.Yesgoose-docs.ai/docs/guides/config-files
SSEConnects over the older HTTP+SSE transport.Nogoose-docs.ai/docs/guides/config-files
OAuthSigns in to remote servers with OAuth.Yesgoose-docs.ai/docs/getting-started/using-extensions

Worth knowing

goose docs state it no longer advertises or handles sampling/createMessage requests after sampling was deprecated in the 2026-07-28 MCP spec, and that SSE extensions are not supported.

FAQ

Where is the goose MCP config?

extensions key in ~/.config/goose/config.yaml (macOS/Linux) or %APPDATA%\Block\goose\config\config.yaml (Windows); or goose configure. The example on this page is copied from https://goose-docs.ai/docs/getting-started/using-extensions/

Does goose support remote MCP servers over Streamable HTTP?

Yes, per https://goose-docs.ai/docs/guides/config-files/. Its docs list support for stdio and Streamable HTTP and say SSE is not supported.

Does goose support OAuth for MCP servers?

Yes. It handles OAuth sign-in for remote servers. Source: https://goose-docs.ai/docs/getting-started/using-extensions/

Which MCP features does goose support?

Its docs list Tools, Resources, Prompts, Roots and Elicitation. They say Sampling is not supported. They do not state Discovery and Instructions.

Sources

Last verified from the pages below.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.