Set up brain.md in Goose

communitystreamable_httpunknown

Local-first markdown notes with a first-class MCP server. 16 tools + 2 resources for Claude Code, Claude Desktop, Cursor and any MCP agent. Per-folder permissions, semantic RAG via LanceDB, single Bun binary. AGPL.

01Configuration

{
  "mcpServers": {
    "brain-md": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://brainmd.example.com/mcp"
      ]
    }
  }
}

Remote server. This uses the mcp-remote bridge so Goose can reach the hosted endpoint. Add it to ~/.config/goose/config.yaml.

02Steps

Make sure Goose is installed and up to date.
Open ~/.config/goose/config.yaml and add the block above (merge into any existing mcpServers).
Provide any required API keys/credentials as environment variables.
Restart Goose and confirm brain.md’s tools appear.

03Other runtimes

Claude Desktop Cursor Windsurf Cline Continue VS Code OpenAI Agents SDK LangGraph CrewAI

04Provenance

config_sourcegenerated from captured install method

last_checked2026-08-16 22:37Z

sourcesGitHub repo search [p4]

Next step

Want agents that act within guardrails? Apex is the live governed-agent product — paced, capped, and fully-logged actions with approvals before anything runs.

Explore Apex →

See also: server page · is it safe? · alternatives