TherapyNotes progress notes already contain every field an ASAM placement decision needs
Addiction counselors working in TherapyNotes document inside a structured SOAP progress note that enforces five required entries before save: Diagnosis, Safety Issues, Objectives, Plan, and Recommendation. The template editor adds optional elements such as Risk Assessment, Current Mental Status, Interventions Used, and Outcome Measures. The ASAM multidimensional assessment fits inside this existing structure without a custom form or a separate document upload.
The real documentation gap is traceability. Utilization reviewers approving intensive outpatient, partial hospitalization, or residential care want to see each ASAM dimension rated and the placement tied to those ratings. Generic scribes return one narrative block that the counselor must cut apart by hand, and the dimensional logic often disappears in the process.
Merry AI writes into the TherapyNotes DOM from the clinician's own browser
The Merry AI Chrome Extension reads the rendered progress note page in the active tab, locates fields by their visible labels and placeholders, and writes approved text into the same input, textarea, and select elements the clinician would otherwise type into. No data passes through a TherapyNotes server API, a vendor marketplace listing, or an HL7 or FHIR interface.
Because injection happens client-side, TherapyNotes native validation still runs when the note is saved. The extension never blanks the Diagnosis field, never overwrites the DSM-5-TR code pulled forward from the Treatment Plan, and never checks 'Patient denies all areas of risk' when any dimension is rated 2 or higher. Injection is scoped to the active tab only, which prevents one client's content from reaching another client's open chart.
Every ASAM dimension receives a 0 to 4 risk rating tied to session evidence
ASAM dimensional risk ratings run from 0, meaning no current risk, to 4, meaning severe risk that requires immediate high-intensity intervention. Merry drafts one rating per dimension and attaches the specific session statements that support it, so the counselor confirms or changes each score instead of writing it from memory.
Dimension 1 covers acute intoxication and withdrawal potential. The draft cites last use, quantity, withdrawal history, and any scored instrument such as CIWA-Ar or COWS. Merry routes this rating to the Safety Issues and Risk Assessment fields.
Dimension 2 covers biomedical conditions and complications, including pregnancy, hepatic findings, chronic pain, and infectious disease. Dimension 3 covers emotional, behavioral, or cognitive conditions, including co-occurring diagnoses, current suicidal ideation, and trauma symptoms. Any self-harm content is flagged for clinician entry of Intent, Plans, and Means, which Merry never auto-completes.
Dimension 4 covers readiness to change, documented through stage of change and the client's own language about use. Dimension 5 covers relapse and continued use potential, including craving intensity, prior relapse timing, and coping skills. Dimension 6 covers the recovery and living environment, including housing stability, substance use in the home, and recovery supports.
A worked example shows how six ratings justify Level 2.1 intensive outpatient
Consider a 34-year-old client with severe alcohol use disorder meeting seven DSM-5-TR criteria. The session yields these drafted ratings: Dimension 1 rated 1 (last drink four days ago, CIWA-Ar of 6, no seizure or delirium history); Dimension 2 rated 1 (elevated liver enzymes followed by primary care); Dimension 3 rated 2 (co-occurring major depressive disorder, PHQ-9 of 14, denies suicidal ideation); Dimension 4 rated 2 (contemplation stage, ambivalent about abstinence); Dimension 5 rated 3 (two relapses within 30 days of the last outpatient discharge, no reliable craving response); Dimension 6 rated 2 (partner drinks at home, stable housing, supportive sibling nearby).
Placement logic follows the highest-risk dimensions. A Dimension 5 rating of 3 exceeds what Level 1 weekly outpatient addresses, as shown by repeated relapse after that level. Dimensions 1 and 2 at 1 do not call for withdrawal management or a medically monitored setting. Dimension 6 at 2 does not require residential care because the sibling offers an alternative environment. Level 2.1 intensive outpatient, at 9 or more structured hours per week for adults, is the least restrictive setting that safely addresses the profile.
Merry places this rationale where reviewers look for it. The six ratings go into the Assessment field, the placement argument goes into Plan and Recommendation, and dimension-linked goals such as reducing Dimension 5 risk from 3 to 2 go into Objectives. Programs using the ASAM Criteria Fourth Edition can load a template that reflects its revised dimension names and level structure.
Mapping the Assessment field takes three steps on first install
Step one: install the extension. Add Merry AI from the Chrome Web Store, sign in with your practice credentials, and pin the icon to the toolbar. No administrator rights, VPN changes, or TherapyNotes account settings are involved.
Step two: open a progress note. In TherapyNotes, open an appointment set to Therapy Session and create the Progress Note. The extension detects the page and displays the Merry overlay panel beside the form.
Step three: map the Assessment field. Click Map Fields in the overlay, then click the Assessment text area in the note and assign it as the destination for the ASAM dimensional summary. Repeat for Plan, Recommendation, Objectives, and Risk Assessment. Mappings save per template, so every later note using that template fills the same fields automatically after you approve the draft.
Browser-native DOM mapping bypasses EHR marketplace paywalls entirely
Three integration paths exist for getting a drafted note into TherapyNotes. The comparison below shows where each path costs time, money, or compliance exposure.
| Criteria | Traditional API Marketplace Integration | Manual Copy-Paste | Merry AI Chrome DOM Injection |
|---|---|---|---|
| Setup time | Weeks to months of vendor review | None | Under 10 minutes |
| IT involvement | Contracts, credentials, security review | None | None |
| Recurring fees | Per-provider or per-call API charges | None | No API fees |
| Field-level placement | Depends on what the API exposes | Manual, field by field | Direct writes to mapped fields |
| ASAM D1 to D6 structure | Rarely supported | Counselor rebuilds by hand | Rated 0 to 4 per dimension |
| Required field validation | Can conflict with EHR rules | Native | Native, never bypassed |
| Audio retention | Often cloud stored | Not applicable | RAM only, zero-day retention |
| Charting time per note | Low after setup | 8 to 15 minutes | Review and sign |
Part 2 records stay inside TherapyNotes because audio never leaves RAM
Substance use disorder treatment records fall under 42 CFR Part 2, which adds redisclosure limits and protections against use in legal proceedings beyond standard HIPAA. The 2024 final rule aligned Part 2 more closely with HIPAA, with compliance required by February 16, 2026, but SUD records still carry stricter handling expectations than general medical records.
Merry processes session audio in browser memory and discards it once the draft is produced. No audio file and no transcript are stored on Merry servers, and processing is covered by an executed BAA. The only persistent copy of the clinical content is the note the clinician signs inside TherapyNotes, the system already governed by the practice's Part 2 and HIPAA controls.
Psychotherapy process notes stay separate. HIPAA treats psychotherapy notes as distinct from the medical record. Merry's addiction counseling templates keep the counselor's private process impressions out of the progress note, and TherapyNotes provides a separate Psychotherapy Note type for that content.
G2211 applies only when a prescriber bills an E/M visit, not counseling codes
Counselors billing psychotherapy or HCPCS H-codes such as H0004 and H0005 cannot report G2211, because CMS ties the add-on to office or outpatient E/M codes 99202 to 99205 and 99211 to 99215, plus home or residence E/M codes. For counselor-only notes, the ASAM structure supports medical necessity, not complexity add-ons.
Addiction medicine prescribers documenting in TherapyNotes can report G2211 when they serve as the continuing focal point for a patient's serious or complex condition, such as ongoing buprenorphine management for opioid use disorder. Merry separates medication decisions tied to Dimensions 1 and 2 from psychotherapy content tied to Dimension 4, which keeps the E/M work identifiable.
Psychotherapy add-on codes 90833, 90836, and 90838 are reported with an E/M visit without Modifier 25. Modifier 25 applies when a significant, separately identifiable E/M service accompanies a procedure, and Modifier 59 rarely applies to counseling encounters. ASAM rationale should never be used to justify either modifier.
Copied ASAM boilerplate invites audit denials. Merry drafts every rating from the current session and references prior episodes, such as earlier withdrawal management stays or relapse dates, so the longitudinal record shows real clinical change across encounters.
State AI laws require clinician review, which Merry builds into every note
California AB 3030 requires disclosure when generative AI produces patient communications containing clinical information, unless a licensed provider reviews them first. California SB 1120 requires that health plan medical necessity determinations be made by licensed clinicians rather than algorithms. Texas lawmakers advanced AI governance in HB 1709 and enacted related health care AI provisions in 2025. Practices should confirm current duties with counsel, but each law points the same direction: a licensed human reviews and owns the decision.
No injected text becomes final until the counselor reviews each ASAM rating, edits the placement rationale, and signs the note in TherapyNotes. The signature attests to clinical judgment, and the record reflects the clinician's decision, not the draft.




