Therapyportal MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add therapyportal-mcp -e 'THERAPYPORTAL_PRACTICE=<THERAPYPORTAL_PRACTICE>' -- npx -y @chrischall/therapyportal-mcp

{
  "mcpServers": {
    "therapyportal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/therapyportal-mcp"
      ],
      "env": {
        "THERAPYPORTAL_PRACTICE": "<THERAPYPORTAL_PRACTICE>"
      }
    }
  }
}

[mcp_servers.therapyportal-mcp]
command = "npx"
args = ["-y", "@chrischall/therapyportal-mcp"]
env = { THERAPYPORTAL_PRACTICE = "<THERAPYPORTAL_PRACTICE>" }

{
  "mcpServers": {
    "therapyportal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/therapyportal-mcp"
      ],
      "env": {
        "THERAPYPORTAL_PRACTICE": "<THERAPYPORTAL_PRACTICE>"
      }
    }
  }
}

{
  "servers": {
    "therapyportal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/therapyportal-mcp"
      ],
      "env": {
        "THERAPYPORTAL_PRACTICE": "<THERAPYPORTAL_PRACTICE>"
      }
    }
  }
}

Put your own value in place of <THERAPYPORTAL_PRACTICE> (Your practice's portal code: the part after /p/ in its TherapyPortal URL (www.therapyportal.com/p/<code>/)). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: THERAPYPORTAL_EMAIL (The email you sign in to TherapyPortal with. Set with the password to sign in server-side; leave both empty to relay through your signed-in browser tab), THERAPYPORTAL_PASSWORD (Your TherapyPortal password. A rejected sign-in is never retried automatically), THERAPYPORTAL_DOB (Only if the portal asks for a date of birth at sign-in: that date, as MM/DD/YYYY. Tried once; never retried, because the portal limits attempts), THERAPYPORTAL_TRANSPORT (server or fetchproxy. Default: server when email and password are both set, otherwise fetchproxy), THERAPYPORTAL_WS_PORT (fetchproxy concentrator port (fetchproxy transport only, default 37149). The whole fleet shares this one port; override only when hosting), THERAPYPORTAL_OUTPUT_DIR (Where downloaded files are written on the server transport (a path-delimiter list; ~ expands). Default ~/Downloads and ~/Documents. A per-call dest must resolve inside one of these), THERAPYPORTAL_INLINE_DOWNLOADS (true returns downloaded bytes inline (base64) instead of writing to disk, for a hosted runner whose disk you cannot reach. Default false), THERAPYPORTAL_UPLOAD_DIR (Folders an upload's file_path must be inside (a path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop; $MCP_DATA_DIR/uploads when hosted), MCP_CONFIRM_MODE (Confirm-gate mode for every write (secure messages, document uploads). ask-user (default) returns a preview + confirmToken and needs a second call with that token; auto lets a capable host confirm in one step; an unrecognised value fails closed (refuse)), MCP_CONFIRM_ELICITATION (on (default) lets the host confirm a write interactively; off forces the confirmToken round-trip), FETCHPROXY_WS_HOST (Bind interface for the fetchproxy concentrator, a literal IP only (default 127.0.0.1). Keep on loopback; it exists for hosted deployments that run each MCP in its own network namespace), FETCHPROXY_IDENTITY_DIR (Absolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/)).