プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Therapyportal MCP

作者:chrischallバージョン 0.5.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.chrischall/therapyportal-mcp

インストール方法

What it does

TherapyNotes client portal: appointments, documents, billing, messages; confirm-gated sends, uploads

  • Connects パソコンで動く
  • Account or key Needs THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB · 1 setting to fill in (THERAPYPORTAL_PRACTICE)
  • Category 文書・表計算・事務作業

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9191 個の skill

Skill · 手順書ライセンス記載なし

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7231 個の skill

Skill · 手順書

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,104 (whole repo)5 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気22/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア34/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Therapyportal MCP をインストールして。https://mcp.popnx.com/i/chrischall-therapyportal-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Therapyportal MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "therapyportal": { "command": "npx", "args": [ "-y", "@chrischall/therapyportal-mcp" ], "env": { "THERAPYPORTAL_PRACTICE": "your-value", "THERAPYPORTAL_PASSWORD": "your-value", "THERAPYPORTAL_DOB": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB, THERAPYPORTAL_PRACTICE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Therapyportal MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Therapyportal MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • THERAPYPORTAL_PRACTICE お使いの診療所のポータルコード:TherapyPortal の URL にある /p/ の後ろの部分 (www.therapyportal.com/p/ /)
      英語の原文を見るYour practice's portal code: the part after /p/ in its TherapyPortal URL (www.therapyportal.com/p/ /).

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "therapyportal": {
          "command": "npx",
          "args": [
            "-y",
            "@chrischall/therapyportal-mcp"
          ],
          "env": {
            "THERAPYPORTAL_PRACTICE": "your-value",
            "THERAPYPORTAL_PASSWORD": "your-value",
            "THERAPYPORTAL_DOB": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    Therapyportal MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Therapyportal MCP を使っていると言うか、回答に Therapyportal MCP のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • 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_TRANSPORT server または fetchproxy。デフォルトは、メールアドレスとパスワードの両方が設定されている場合は server、それ以外は fetchproxy です。
    英語の原文を見るserver or fetchproxy. Default: server when email and password are both set, otherwise fetchproxy.
  • THERAPYPORTAL_WS_PORT fetchproxy コンセントレータのポート(fetchproxy トランスポートのみ、デフォルト 37149)。フリート全体で同じポートを共有するため、自前ホスティング時のみ変更
    英語の原文を見るfetchproxy concentrator port (fetchproxy transport only, default 37149). The whole fleet shares this one port; override only when hosting.
  • THERAPYPORTAL_OUTPUT_DIR サーバー転送でダウンロードしたファイルの保存先(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads と /Documents です。呼び出しごとの dest は、これらのいずれかの内側に解決される必要があります
    英語の原文を見る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 に設定すると、ダウンロードしたバイト列をディスクに書き込まず、インライン(base64)で返します。ディスクに接続できないホスト型ランナー向けです。デフォルトは false です。
    英語の原文を見る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 アップロードの file_path が含まれている必要があるフォルダ(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads、/Documents、/Desktop。ローカルインストールのみ。ホスト型サーバーは file_path を拒否し、アップロード…
    英語の原文を見るFolders an upload's file_path must be inside (a path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop. Local installs only: a hosted server refuses file_path and takes uploa…
  • 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…
  • MCP_CONFIRM_ELICITATION on(既定)はホストが書き込みを対話的に確認できるようにします。off は confirmToken のやり取りを必須にします。
    英語の原文を見る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 fetchproxy の長期ID鍵ペアが保存される絶対パス(デフォルト /.fetchproxy/identity/)
    英語の原文を見るAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Therapyportal MCP につなげません

Therapyportal MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Therapyportal MCP につなげるアプリを使う

  • Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 文書・表計算・事務作業 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Therapyportal MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user therapyportal --env THERAPYPORTAL_PRACTICE=your-value --env THERAPYPORTAL_PASSWORD=your-value --env THERAPYPORTAL_DOB=your-value -- npx -y @chrischall/therapyportal-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB, THERAPYPORTAL_PRACTICE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Therapyportal MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Therapyportal MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • THERAPYPORTAL_PRACTICE お使いの診療所のポータルコード:TherapyPortal の URL にある /p/ の後ろの部分 (www.therapyportal.com/p/ /)
      英語の原文を見るYour practice's portal code: the part after /p/ in its TherapyPortal URL (www.therapyportal.com/p/ /).

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user therapyportal --env THERAPYPORTAL_PRACTICE=your-value --env THERAPYPORTAL_PASSWORD=your-value --env THERAPYPORTAL_DOB=your-value -- npx -y @chrischall/therapyportal-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    Therapyportal MCP が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    Therapyportal MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Therapyportal MCP を使っていると言うか、回答に Therapyportal MCP のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • 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_TRANSPORT server または fetchproxy。デフォルトは、メールアドレスとパスワードの両方が設定されている場合は server、それ以外は fetchproxy です。
    英語の原文を見るserver or fetchproxy. Default: server when email and password are both set, otherwise fetchproxy.
  • THERAPYPORTAL_WS_PORT fetchproxy コンセントレータのポート(fetchproxy トランスポートのみ、デフォルト 37149)。フリート全体で同じポートを共有するため、自前ホスティング時のみ変更
    英語の原文を見るfetchproxy concentrator port (fetchproxy transport only, default 37149). The whole fleet shares this one port; override only when hosting.
  • THERAPYPORTAL_OUTPUT_DIR サーバー転送でダウンロードしたファイルの保存先(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads と /Documents です。呼び出しごとの dest は、これらのいずれかの内側に解決される必要があります
    英語の原文を見る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 に設定すると、ダウンロードしたバイト列をディスクに書き込まず、インライン(base64)で返します。ディスクに接続できないホスト型ランナー向けです。デフォルトは false です。
    英語の原文を見る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 アップロードの file_path が含まれている必要があるフォルダ(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads、/Documents、/Desktop。ローカルインストールのみ。ホスト型サーバーは file_path を拒否し、アップロード…
    英語の原文を見るFolders an upload's file_path must be inside (a path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop. Local installs only: a hosted server refuses file_path and takes uploa…
  • 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…
  • MCP_CONFIRM_ELICITATION on(既定)はホストが書き込みを対話的に確認できるようにします。off は confirmToken のやり取りを必須にします。
    英語の原文を見る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 fetchproxy の長期ID鍵ペアが保存される絶対パス(デフォルト /.fetchproxy/identity/)
    英語の原文を見るAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Therapyportal MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "therapyportal": { "command": "npx", "args": [ "-y", "@chrischall/therapyportal-mcp" ], "env": { "THERAPYPORTAL_PRACTICE": "your-value", "THERAPYPORTAL_PASSWORD": "your-value", "THERAPYPORTAL_DOB": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB, THERAPYPORTAL_PRACTICE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Therapyportal MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Therapyportal MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • THERAPYPORTAL_PRACTICE お使いの診療所のポータルコード:TherapyPortal の URL にある /p/ の後ろの部分 (www.therapyportal.com/p/ /)
      英語の原文を見るYour practice's portal code: the part after /p/ in its TherapyPortal URL (www.therapyportal.com/p/ /).

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    Therapyportal MCP の設定で THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB, THERAPYPORTAL_PRACTICE が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    Therapyportal MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Therapyportal MCP を使っていると言うか、回答に Therapyportal MCP のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • 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_TRANSPORT server または fetchproxy。デフォルトは、メールアドレスとパスワードの両方が設定されている場合は server、それ以外は fetchproxy です。
    英語の原文を見るserver or fetchproxy. Default: server when email and password are both set, otherwise fetchproxy.
  • THERAPYPORTAL_WS_PORT fetchproxy コンセントレータのポート(fetchproxy トランスポートのみ、デフォルト 37149)。フリート全体で同じポートを共有するため、自前ホスティング時のみ変更
    英語の原文を見るfetchproxy concentrator port (fetchproxy transport only, default 37149). The whole fleet shares this one port; override only when hosting.
  • THERAPYPORTAL_OUTPUT_DIR サーバー転送でダウンロードしたファイルの保存先(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads と /Documents です。呼び出しごとの dest は、これらのいずれかの内側に解決される必要があります
    英語の原文を見る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 に設定すると、ダウンロードしたバイト列をディスクに書き込まず、インライン(base64)で返します。ディスクに接続できないホスト型ランナー向けです。デフォルトは false です。
    英語の原文を見る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 アップロードの file_path が含まれている必要があるフォルダ(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads、/Documents、/Desktop。ローカルインストールのみ。ホスト型サーバーは file_path を拒否し、アップロード…
    英語の原文を見るFolders an upload's file_path must be inside (a path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop. Local installs only: a hosted server refuses file_path and takes uploa…
  • 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…
  • MCP_CONFIRM_ELICITATION on(既定)はホストが書き込みを対話的に確認できるようにします。off は confirmToken のやり取りを必須にします。
    英語の原文を見る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 fetchproxy の長期ID鍵ペアが保存される絶対パス(デフォルト /.fetchproxy/identity/)
    英語の原文を見るAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Therapyportal MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (THERAPYPORTAL_PRACTICE) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Therapyportal MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "therapyportal": { "type": "stdio", "command": "npx", "args": [ "-y", "@chrischall/therapyportal-mcp" ], "env": { "THERAPYPORTAL_PRACTICE": "your-value", "THERAPYPORTAL_PASSWORD": "your-value", "THERAPYPORTAL_DOB": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB, THERAPYPORTAL_PRACTICE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Therapyportal MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Therapyportal MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • THERAPYPORTAL_PRACTICE お使いの診療所のポータルコード:TherapyPortal の URL にある /p/ の後ろの部分 (www.therapyportal.com/p/ /)
      英語の原文を見るYour practice's portal code: the part after /p/ in its TherapyPortal URL (www.therapyportal.com/p/ /).

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    Therapyportal MCP の設定で THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB, THERAPYPORTAL_PRACTICE が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    Therapyportal MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Therapyportal MCP を使っていると言うか、回答に Therapyportal MCP のツール名が出れば接続成功です

追加の設定 10 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • 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_TRANSPORT server または fetchproxy。デフォルトは、メールアドレスとパスワードの両方が設定されている場合は server、それ以外は fetchproxy です。
    英語の原文を見るserver or fetchproxy. Default: server when email and password are both set, otherwise fetchproxy.
  • THERAPYPORTAL_WS_PORT fetchproxy コンセントレータのポート(fetchproxy トランスポートのみ、デフォルト 37149)。フリート全体で同じポートを共有するため、自前ホスティング時のみ変更
    英語の原文を見るfetchproxy concentrator port (fetchproxy transport only, default 37149). The whole fleet shares this one port; override only when hosting.
  • THERAPYPORTAL_OUTPUT_DIR サーバー転送でダウンロードしたファイルの保存先(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads と /Documents です。呼び出しごとの dest は、これらのいずれかの内側に解決される必要があります
    英語の原文を見る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 に設定すると、ダウンロードしたバイト列をディスクに書き込まず、インライン(base64)で返します。ディスクに接続できないホスト型ランナー向けです。デフォルトは false です。
    英語の原文を見る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 アップロードの file_path が含まれている必要があるフォルダ(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads、/Documents、/Desktop。ローカルインストールのみ。ホスト型サーバーは file_path を拒否し、アップロード…
    英語の原文を見るFolders an upload's file_path must be inside (a path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop. Local installs only: a hosted server refuses file_path and takes uploa…
  • 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…
  • MCP_CONFIRM_ELICITATION on(既定)はホストが書き込みを対話的に確認できるようにします。off は confirmToken のやり取りを必須にします。
    英語の原文を見る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 fetchproxy の長期ID鍵ペアが保存される絶対パス(デフォルト /.fetchproxy/identity/)
    英語の原文を見るAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Therapyportal MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user therapyportal --env THERAPYPORTAL_PRACTICE=your-value --env THERAPYPORTAL_PASSWORD=your-value --env THERAPYPORTAL_DOB=your-value -- npx -y @chrischall/therapyportal-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "therapyportal": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/therapyportal-mcp"
      ],
      "env": {
        "THERAPYPORTAL_PRACTICE": "your-value",
        "THERAPYPORTAL_PASSWORD": "your-value",
        "THERAPYPORTAL_DOB": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "therapyportal": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/therapyportal-mcp"
      ],
      "env": {
        "THERAPYPORTAL_PRACTICE": "your-value",
        "THERAPYPORTAL_PASSWORD": "your-value",
        "THERAPYPORTAL_DOB": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "therapyportal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/therapyportal-mcp"
      ],
      "env": {
        "THERAPYPORTAL_PRACTICE": "your-value",
        "THERAPYPORTAL_PASSWORD": "your-value",
        "THERAPYPORTAL_DOB": "your-value"
      }
    }
  }
}

自分で入力する値

  • THERAPYPORTAL_PRACTICE 必須 env
    お使いの診療所のポータルコード:TherapyPortal の URL にある /p/ の後ろの部分 (www.therapyportal.com/p/ /)
    英語の原文を見るYour practice's portal code: the part after /p/ in its TherapyPortal URL (www.therapyportal.com/p/ /).
  • THERAPYPORTAL_EMAIL env
    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 秘密 必須 env
    TherapyPortal のパスワード。サインインが拒否された場合は自動で再試行されません。
    英語の原文を見るYour TherapyPortal password. A rejected sign-in is never retried automatically.
  • THERAPYPORTAL_DOB 秘密 必須 env
    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 env
    server または fetchproxy。デフォルトは、メールアドレスとパスワードの両方が設定されている場合は server、それ以外は fetchproxy です。
    英語の原文を見るserver or fetchproxy. Default: server when email and password are both set, otherwise fetchproxy.
  • THERAPYPORTAL_WS_PORT env
    fetchproxy コンセントレータのポート(fetchproxy トランスポートのみ、デフォルト 37149)。フリート全体で同じポートを共有するため、自前ホスティング時のみ変更
    英語の原文を見るfetchproxy concentrator port (fetchproxy transport only, default 37149). The whole fleet shares this one port; override only when hosting.
  • THERAPYPORTAL_OUTPUT_DIR env
    サーバー転送でダウンロードしたファイルの保存先(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads と /Documents です。呼び出しごとの dest は、これらのいずれかの内側に解決される必要があります
    英語の原文を見る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 env
    true に設定すると、ダウンロードしたバイト列をディスクに書き込まず、インライン(base64)で返します。ディスクに接続できないホスト型ランナー向けです。デフォルトは false です。
    英語の原文を見る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 env
    アップロードの file_path が含まれている必要があるフォルダ(パス区切り文字で区切ったリスト。 は展開されます)。既定値は /Downloads、/Documents、/Desktop。ローカルインストールのみ。ホスト型サーバーは file_path を拒否し、アップロード…
    英語の原文を見るFolders an upload's file_path must be inside (a path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop. Local installs only: a hosted server refuses file_path and takes uploa…
  • MCP_CONFIRM_MODE env
    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…
  • MCP_CONFIRM_ELICITATION env
    on(既定)はホストが書き込みを対話的に確認できるようにします。off は confirmToken のやり取りを必須にします。
    英語の原文を見るon (default) lets the host confirm a write interactively; off forces the confirmToken round-trip.
  • FETCHPROXY_WS_HOST env
    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 env
    fetchproxy の長期ID鍵ペアが保存される絶対パス(デフォルト /.fetchproxy/identity/)
    英語の原文を見るAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
954/週
接続方法
パソコンで動く
最新バージョンi
0.5.0
レジストリ公開日i
2026年11月12日
コードの最終更新i
2026年11月12日
作者
chrischall
パッケージ
npm: @chrischall/therapyportal-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント chrischall で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:7 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @chrischall/therapyportal-mcp@0.5.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/chrischall-therapyportal-mcp.svg)](https://mcp.popnx.com/en/servers/chrischall-therapyportal-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

文書・表計算・事務作業のほかのサーバーとの比較i

  • このカテゴリのほかの4126件のうち0%よりスターが多い
  • このカテゴリのほかの4126件のうち81%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの4126件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Therapyportal MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:THERAPYPORTAL_PASSWORD, THERAPYPORTAL_DOB

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は7 日前、最新バージョン(0.5.0)がレジストリに届いたのは7 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter広く使われている★ 4.4万5 か月前更新

クラウドで動く✓ 提供元 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry広く使われている↓ 13万/週 共有パッケージの数★ 65884 か月前更新

パソコンで動く✓ 提供元 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai広く使われている★ 29942 か月前更新

クラウドで動く✓ 提供元 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp成長中↓ 1136/週★ 567先月更新

パソコンで動く✓ 提供元 · ankimcp.ai
似たものと比べる
これ
Therapyportal MCP
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要
キーが必要はいいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/34/43/32/44/43/3
ライセンスMITAGPL-3.0MITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

therapyportal-mcp

MCP server for TherapyPortal, the client portal of TherapyNotes (https://www.therapyportal.com/p/ /). It reads upcoming therapy appointments, paperwork the practice sent, the practice's standing forms, balances due, payment receipts and secure messages, and downloads completed documents and receipts as PDFs. It can also send secure messages and upload a file in answer to a document request, each behind a confirm gate.

This project was developed and is maintained by AI. Use at your own discretion.

It reads mental-health records, and only ever from the signed-in user's own account.

Not read-only

Most tools are reads. Three are writes, and each one reaches the practice and cannot be undone through this server:

ToolWhat it sendsLook up first with
therapyportal_send_messagea new secure-message conversation, for one client, under a topictherapyportal_list_message_topics
therapyportal_reply_messagea reply in an existing conversation (leaves read state alone unless mark_thread_read)therapyportal_list_message_threads
therapyportal_upload_documenta file (local path, inline base64, or an upload slot when hosted) in answer to a pending document request, or an upload-required always-available formtherapyportal_list_documents, therapyportal_list_forms

All three are annotated destructive and confirm-gated (see below). The server signs no form, fills in no form and makes no payment. Anything that needs a signature (PatientSignatureRequired) is refused, with a pointer to the portal. A download is logged by the practice, the same way the portal logs the click.

On the privacy side, therapyportal_list_clients returns names and date of birth only. The portal's client record also carries the address, phones, email, an SSN field, billing notes and free-text comments, and none of those are ever passed through, on any view.

Tools

ToolWhat it returns
therapyportal_list_clientsthe clients linked to this login (for a parent, each child), with the patientId other tools take
therapyportal_list_appointmentsupcoming appointments: time, clinician, telehealth or location, which client; pending requests; practice phone. The portal shows no past visits
therapyportal_list_documentspaperwork requests (pending / completed / all) and their documents, with portalDocumentId and whether each needs an upload or a signature
therapyportal_list_formsthe practice's always-available forms (sign or upload as needed), with libraryDocumentId
therapyportal_get_document_countsper client, documents waiting to be completed or approved
therapyportal_list_balancesthe balance due per client, and whether autopay is on
therapyportal_list_receiptspayments, with the dates of service each covered, and paymentId
therapyportal_list_message_threadsone client's secure-message conversations (does not mark read)
therapyportal_get_thread_messagesthe messages in one conversation (does not mark read); format: "markdown" or "text" reads each body without its HTML
therapyportal_download_documenta completed form (rendered to PDF) or a file the practice uploaded
therapyportal_download_receipta payment receipt PDF
therapyportal_list_message_topicsthe topics a client can message (topicId, and whether each reaches clinical, billing or administrative staff), whether messaging is on, and whether the client has an assigned clinician
therapyportal_send_messagewrite. Start a new conversation (confirm-gated)
therapyportal_reply_messagewrite. Reply in a conversation (confirm-gated)
therapyportal_upload_documentwrite. Upload a PDF, JPG, JPEG, PNG, HEIC or DOCX (max 25 MB) for a document that asks for one (confirm-gated)
therapyportal_upload_slothosted only: a signed URL to PUT one file to, whose blobKey therapyportal_upload_document then takes. Sends nothing to the practice
therapyportal_healthcheckconnectivity, from whichever transport is live

Read tools take view. The default is compact (projected to the useful fields); full and raw return more. Text the practice wrote (document titles, instructions, messages) comes back inside an untrusted-content envelope.

Message tools are not verified against real messages. The account this was built against had none, so the thread and message reads return the portal's payload exactly as sent rather than a projection.

Writes

The three writes are derived from the portal's own JavaScript (SecureMessagingDataService, CreateMessageViewV2, ThreadViewV2, DocumentsDataService, the document view controllers and xhrfileuploader) and are UNVERIFIED on the wire: no automated run sends a message or uploads a file, because each one reaches the practice. An owner-supervised live test confirms them later. The lookups they make first (messaging settings, topics, the assigned-clinician check, the document and form lists) were verified live, read-only.

Before showing a preview, each write checks against live reads: the client is one of yours (therapyportal_list_clients), the practice has secure messaging turned on, the topic exists for that client, and, for an upload, that the document or form exists, is not completed, asks for an upload and needs no signature.

  • Messages. 1 to 5000 characters. Plain text by default, sent as the portal's editor sends it (one HTML paragraph per line). With format: "markdown", bold, italic, lists, headings and quotes are sent formatted, limited to what the portal's editor offers a client; a link is sent as its text and address, since clients get no link tool. A practice may refuse new messages after several unanswered ones; a refusal says so. Archived conversations cannot be replied to.
  • Uploads. Give exactly one source:
  • file_path (local installs): the file must be inside THERAPYPORTAL_UPLOAD_DIR (default ~/Downloads, ~/Documents or ~/Desktop) and be a regular file (no symlinks). A hosted server refuses file_path with a "this server is remote" error: it cannot see the caller's files.
  • inline ({filename, content_base64, mime_type?}): the bytes as base64, strictly decoded (a truncated or mangled payload is refused, not sent). Works anywhere, but every byte rides in one request; keep it small.
  • blob_key (hosted): call therapyportal_upload_slot with the filename, PUT the file to the returned uploadUrl (its curl does exactly that), then pass the blobKey. The preview reads the uploaded copy and binds its SHA-256; the confirmed call re-reads it (a changed file is refused) and deletes it only once the portal accepted the upload. A failed or unconfirmed upload keeps it; a failed delete is reported, not thrown.

Every source gets the same checks: an allowlisted extension, contents that match it, at most 25 MB, and the SHA-256 in the preview. Legacy .doc is refused (its format cannot be checked before upload); save it as PDF or .docx. The file is staged in 100 KB segments, validated by the portal, and only then submitted. Only the submit reaches the practice.

  • Sent once. A write is posted exactly once. It is never replayed after a re-sign-in, on either transport. A send the portal answers with a 5xx, or whose connection drops, is reported as status: "unknown" rather than as an error, so a model checks the matching list before trying again instead of sending twice.

Confirm gate

Every write is gated by @chrischall/mcp-utils' confirmWrite, through its defineWrite / registerWrite. The first call sends nothing and returns a preview + a `confirmToken`; only a second call carrying that token, after you approve the preview, sends. The exact request (for an upload, the file's name, type, size and SHA-256) and the shown preview are bound into the token, so an argument, file or portal state that changed since the preview is refused as DRAFT_CHANGED. Values that change on every send (the upload guid, the document date) are made at send time and are not bound. Practice-written text in a preview or a result (topic names, document titles, the returned conversation) is wrapped as untrusted content. MCP_CONFIRM_MODE / MCP_CONFIRM_ELICITATION tune the gate (see Configuration).

Transports

Server (default when credentials are set)Browser bridge
Howsigns in itself with your email and password; holds a cookie jar in memoryrelays every request through your signed-in Chrome tab via the ContextMint Bridge extension
NeedsTHERAPYPORTAL_EMAIL, THERAPYPORTAL_PASSWORD (and THERAPYPORTAL_DOB if the portal asks)the extension, and a signed-in portal tab
Hostable (claude.ai, phone)yesonly as a bridged registration
Downloadswritten to THERAPYPORTAL_OUTPUT_DIR, or inlinesaved by the browser to its download folder

The two can run side by side. A server-side sign-in does not end your browser's portal session (checked live), and the portal signs out an idle browser tab on its own after a while; that is the usual reason the bridge reports "not signed in".

A rejected password or date of birth is never retried. The date-of-birth check locks after a few wrong dates, so the server tries it once.

Configuration

Variable
THERAPYPORTAL_PRACTICErequired. The code after /p/ in your portal URL (a full URL also works)
THERAPYPORTAL_EMAILthe email you sign in with
THERAPYPORTAL_PASSWORDyour portal password
THERAPYPORTAL_DOBonly if the portal asks for a date of birth at sign-in: MM/DD/YYYY (M/D/YYYY and YYYY-MM-DD are accepted)
THERAPYPORTAL_TRANSPORTserver or fetchproxy. Default: server when email and password are set
THERAPYPORTAL_WS_PORTfetchproxy concentrator port, default 37149 (shared by the whole fleet)
THERAPYPORTAL_OUTPUT_DIRwhere downloads are written (path-delimiter list; ~ expands). Default ~/Downloads and ~/Documents; a per-call dest must be inside one
THERAPYPORTAL_INLINE_DOWNLOADStrue returns downloads inline (base64), for a hosted runner
THERAPYPORTAL_UPLOAD_DIRwhere an upload's file_path must be (path-delimiter list; ~ expands). Default ~/Downloads, ~/Documents and ~/Desktop. Ignored when hosted, where file_path is refused (use therapyportal_upload_slot + blob_key, or inline)
MCP_CONFIRM_MODEconfirm-gate mode for every write. ask-user (default) = preview + confirmToken round-trip; auto lets a capable host confirm in one step; an unrecognised value fails closed (refuse)
MCP_CONFIRM_ELICITATIONon (default) lets the host confirm a write interactively; off forces the confirmToken round-trip
FETCHPROXY_WS_HOST, FETCHPROXY_IDENTITY_DIRfetchproxy bind address and identity directory (advanced)

Copy .env.example to .env for a local install.

{

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

Without the server

skills/therapyportal-fpx does the same reads (not the writes) from a shell with the fpx CLI, through the signed-in tab. See its SKILL.md.

Development

npm install

npm run build npm test # typecheck + vitest, all mocked npm run test:coverage # 100% threshold

The wire protocol (tokens, sign-in, download jobs, the write shapes) is in docs/THERAPYPORTAL-API.md.