Skip to content

EHR Integration Architecture

TherapyNotes Integration for Addiction Counseling

ASAM D1 to D6 ratings scored 0 to 4 write into TherapyNotes progress note fields. Book your audit at https://cal.com/merryai/demo.

Key Takeaways
  • Merry AI writes ASAM Dimension 1 to 6 ratings, each scored 0 to 4, directly into TherapyNotes progress note fields through browser DOM injection
  • Level-of-care rationale lands in the Plan and Recommendation fields so utilization reviewers can trace placement to dimensional risk
  • Session audio is processed in RAM with zero-day retention, keeping 42 CFR Part 2 records inside TherapyNotes
  • Every draft requires clinician review and attestation before chart commit
Verified Metric
6

ASAM Dimensions Rated

Each scored 0 to 4 with cited session evidence.

Verified Metric
<500ms

DOM Field Write-Back

Direct client-side input field injection.

Verified Metric
0-day

Audio Retention

Audio processed in RAM and discarded under executed BAA.

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.

CriteriaTraditional API Marketplace IntegrationManual Copy-PasteMerry AI Chrome DOM Injection
Setup timeWeeks to months of vendor reviewNoneUnder 10 minutes
IT involvementContracts, credentials, security reviewNoneNone
Recurring feesPer-provider or per-call API chargesNoneNo API fees
Field-level placementDepends on what the API exposesManual, field by fieldDirect writes to mapped fields
ASAM D1 to D6 structureRarely supportedCounselor rebuilds by handRated 0 to 4 per dimension
Required field validationCan conflict with EHR rulesNativeNative, never bypassed
Audio retentionOften cloud storedNot applicableRAM only, zero-day retention
Charting time per noteLow after setup8 to 15 minutesReview 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.

Bespoke TherapyNotes Prompt Logic

Bespoke TherapyNotes Prompt Logic

ASAM multidimensional templates map each dimension to the correct TherapyNotes field. Browse Access 1,000+ EHR Clinical Templates to find or generate addiction counseling notes in 5 seconds.

Browser Native

Zero-IT Extension Architecture

Our Chrome Extension runs inside the clinician's active TherapyNotes browser tab and writes to the rendered form fields, with zero API fees and no firewall changes.

Reimbursement

CPT G2211 Complexity Defense

For prescribers billing E/M visits, Merry surfaces longitudinal SUD management evidence that supports G2211 complexity capture. Schedule a 15-Minute Workflow Audit today.

Clinician-Attested Final Record

Clinician-Attested Final Record

Every injected ASAM rating and placement rationale stays editable until the clinician reviews, revises, and signs the TherapyNotes progress note.

Explore More Knowledge

Related EHR & Clinical Integrations Guides

View all ehr & clinical integrations
Cerbo EMR Endocrinology AI Scribe Integration
EHR Integration Architecture

Cerbo EMR Endocrinology AI Scribe Integration

Record 14-day TIR, GMI, and insulin titration directly in Cerbo chart notes. Book your audit at https://cal.com/merryai/demo.

Kaif R.•6 min read
Read guide
CharmHealth Pediatrics: Chrome DOM Note Injection
EHR Integration Architecture

CharmHealth Pediatrics: Chrome DOM Note Injection

Growth z-scores and SOAP notes written directly into CharmHealth from Chrome. Book your audit at https://cal.com/merryai/demo.

Kaif R.•6 min read
Read guide
Elation Health AI Scribe for Internal Medicine
EHR Integration Architecture

Elation Health AI Scribe for Internal Medicine

Merry AI writes LVEF, NYHA class, and GDMT changes into Elation Assessment and Plan blocks. Book your audit at https://cal.com/merryai/demo.

Kaif R.•6 min read
Read guide