mcpfold logomcpfold

← All client guides

Add MCP servers to opencode

Manage opencode’s MCP servers from one canonical config with mcpfold — the free, open-source CLI. Write your servers once and fold them out to opencode’s own mcp config, with secrets kept as references, not hardcoded values.

Set up opencode in 4 steps

  1. Install mcpfold. Install the free, open-source mcpfold CLI — no account required.npm install -g mcpfold
  2. Create your config. Create one canonical mcp.config.jsonc — the single source of truth mcpfold folds out to every client.mcpfold init
  3. Add a server. Add an MCP server from the registry (secrets stay references, versions stay pinned), or run `mcpfold import` to pull in servers you already configured.mcpfold add <server> --from-registry
  4. Fold it out to opencode. Write your servers into opencode's own config (/Users/you/.config/opencode/opencode.json) under its `mcp` key.mcpfold sync

What mcpfold writes for opencode

Config file
/Users/you/.config/opencode/opencode.json
Windows: C:\Users\you\.config\opencode\opencode.json
Config key
mcp
Secrets
Secrets stay as `${env:…}` / `${op:…}` references; mcpfold's launcher resolves them at run time, so opencode's config file never contains a raw token.
Remote servers
opencode reaches http/sse remotes natively — mcpfold writes a native remote entry, no bridge needed.
After sync
Changes are picked up without restarting opencode.

Looking for servers to add? Browse the MCP server directory — every entry adds in one mcpfold add. Or see the install options.

mcpfold is an independent, open-source project and is not affiliated with or endorsed by opencode. Names are used only to describe compatibility.