Lets the app email handoff alerts to staff (e.g. reception) via a CB-PA shared mailbox. Stored encrypted. Body is PHI-minimal (references the chart # / eval id, never the patient name). Requires an Entra app with Mail.Send (application) granted + admin consent, and an ApplicationAccessPolicy restricting it to the sender mailbox.
β Add a user
Add someone by their Microsoft email and check every role they should have. They sign in with Microsoft; if they have more than one role they get a switcher to pick which one they're acting as.
π₯ Users & permissions
Check or uncheck roles to change what each person can do. Changes are saved instantly and logged.
User
Email
Roles
Created
Manage roles
Most recent first β logins, evaluations, user & permission changes.
Time (Texas / CT)
Actor
Action
Detail
IP
Signed in as β
Your signature
Applied to a report only when you sign it. Each psychologist manages their own signature.
Your calendar (SimplePractice)
Paste your own SimplePractice iCal export URL. Your appointments then show on your calendar (read-only) so you can attend and start the intake. Each person uses their own account's iCal β it stays encrypted and private to you.
What is this, and how do I get my calendar link?
What it is. A calendar link (iCal URL) is a private web address for your SimplePractice calendar. Pasting it here lets this app show your appointments (read-only) so you can attend them and start the intake. It is one-way β this app only reads it and never changes anything in SimplePractice.
How to get it, in SimplePractice:
β opens in a new tab, then follow the 3 steps below.
In the SimplePractice tab, click the βοΈ gear (Calendar settings) at the top-right of the calendar.
Click Calendar sync and policies.
Under Calendar URL, click Copy link, then come back here and paste it below and press Save my calendar feed.
No βScheduling and inquiriesβ in your Settings menu? That's fine β use the calendar βοΈ gear above; it works from any account that has a calendar.
Your link shows only your own appointments. Keep it private β treat it like a password.
β Help & Guide
Welcome to the Psychological Evaluation Assistant
This app takes a clinical case from the moment an appointment is booked all the way to a signed, exported psychological evaluation. It reads the scores in the test reports for you, drafts the write-up in the clinic's style, and lets you correct anything before it is finalized.
You can read this guide top to bottom, or jump to your role. If this is your first time, use the Guided walkthrough β it follows one complete case, screen by screen.
The people involved (roles)
Clinician β sees their own appointments, meets the client, and enters the intake during or right after the appointment. Chooses which assessments the client will complete, and later reviews the finished draft and applies the first signature.
Coordinator (front desk) β schedules appointments and coordinates the assessments: sends them out, marks each one Sent, then Completed as results come back. Can see the calendar and patient list.
Drafter β receives the intake and the test reports, generates the draft, and edits it. Is notified when the assessments are all in, and does everything the psychologist does except the final signature.
Psychologist β can do everything the others do, and is the only one who applies the final signature that finalizes the report.
One person can hold more than one role, and the psychologist can see and do everything.
The complete workflow β who does what
A case moves through the clinic in a fixed order. Every hand-off notifies the next person automatically β a bell inside the app, and an email when email notifications are configured.
Book the appointment β Coordinator (front desk). The front desk (the person at the phone) schedules the appointment in SimplePractice; it appears on the calendar in the app.
Attend & intake β Clinician. The clinician meets the client at the appointment and enters the intake (type it, drop a Word/Text file, or paste it). Name, date of birth, parents, and address flow straight into the report header.
Choose the assessments β Clinician. The clinician marks which assessments the client will complete. This starts the coordination and hands off to the front desk.
Send & collect β Coordinator. On the assessment board the coordinator sends each assessment out, marks it Sent, then marks it Completed as results arrive (search by client and tick each one off). When every assessment meant to be sent is completed, the drafter is notified automatically.
Draft β Drafter. The drafter uploads the test reports, presses Generate, and the app reads the scores and writes the draft in the clinic's format.
Review & edit β Drafter. Everything is checked and corrected β scores against the originals, summaries, diagnoses, recommendations β then Submit for review hands it to the clinician.
Clinician signs β Clinician. The clinician reviews the finished draft and applies the first signature (or sends it back with a note). This routes it to the psychologist.
Final signature β Psychologist. The psychologist reviews and applies the final signature, which finalizes and locks the report.
Export. The finished report prints or exports to Word, and stays in a searchable history to reopen anytime.
Roughly 20β30 minutes of active work per evaluation, most of it in step 5 (reviewing and correcting the draft).
Read this first β three things that matter
1. The AI can misread a document. The app uses AI vision to read the numbers off each test report. It is good, but not perfect β a "72" can be read as "12", a scale can be mislabeled, or a value can be missed. Always check the score tables against the original report before you sign. Every number is editable (see below).
2. Everything in the draft is editable. Click any heading, paragraph, score, diagnosis, or recommendation to change it. The document you see is exactly what gets exported β what you type is what prints. Edits save automatically.
3. Nothing leaves your hands until you act. A draft stays private to whoever is working on it. It only moves forward when you press Submit for review, and it is only finalized when the psychologist presses Sign. Before that, you can change anything.
One more: the little attention flags (β) next to scores are an on-screen aid only β they help you notice concerning values. They never appear in the exported report.
Guided walkthrough β one complete case
This follows a sample patient, "Alex Morgan," from booking to a signed report. The data here is fake β no real patient information. Your screens will look the same with real cases.
For the full picture of who hands off to whom β the clinician's intake, choosing and collecting the assessments, and the two-stage signature β see The complete workflow above. The steps below focus on building and finalizing the report itself.
1 Book the appointment ~1 min Β· Receptionist
Booking happens in SimplePractice, the clinic's scheduling system. In the app, open Appointments and click β Book in SimplePractice β β it opens SimplePractice in a new tab. Once booked there, the appointment appears on the app's calendar automatically.
The reception calendar (Week view). Booked appointments show as blue blocks. Switch between Week / Month / List, and use Patients to look someone up.
2 Attend & do the intake ~2β4 min Β· Clinician
On the day of the evaluation, open the appointment and choose Attend β Do intake. Fill in the intake sections, or simply drop the existing .docx / .txt intake onto the form to auto-fill it. When you submit, the app captures the identity and history and, on demand, writes the report's Background.
The intake form. You can type the sections, drop a Word/Text file to auto-fill, or paste the full intake text.
3 Upload the test reports ~1β2 min Β· Drafter
Open the evaluation. In the Test reports panel, drop the reports from QGlobal / MHS, PDF or Word (you can select several at once). These are the source documents the app reads the scores from. After you generate, each file is tagged with how it was read: read from the file (the app knows that report's layout and took the numbers from its own tables) or read by AI.
4 Generate the draft ~1β3 min Β· Drafter
Press β¨ Generate report. The app reads the scores and graphs from the uploaded reports and writes the full evaluation in the clinic's style: background, per-test summaries, the integrative summary, and recommendations. It runs on the server, so you can switch to another evaluation or close the tab while it works. The draft is locked until it finishes, so nothing you type gets overwritten, and the app tells you when it's ready.
Files tagged read by AI, and the Background (which the AI writes), need the closest check. Treat the result as a strong first draft, not a final answer: step 5 is where you verify it.
5 Review and edit β the important part ~10β20 min Β· Drafter / Psychologist
The whole document is now on screen and fully editable. This is the report exactly as it will export.
The complete draft (scroll inside the frame to see it all): letterhead & identity, Reason for Referral, Background, per-test scores and summaries, Summary of Evaluation, Diagnosis, and Recommendations. Click anything to edit it.
Check the scores against the original reports. Each test shows a typed score table. The attention flags (β) point out concerning values β red for the strongest concern, amber for milder β but they are just a nudge. If a number was misread, click the cell and correct it.
A score table. The β marks are on-screen only. Any value, scale, or classification cell can be clicked and edited.
Set the diagnoses. Check the boxes in the picker on the left; each one you check appears in the diagnosis table on the right. You can also type a diagnosis directly, or add one that isn't in the list.
Checking a diagnosis only edits the document β it does not call the AI. Recommendations are rebuilt from these diagnoses the next time you press Generate.
Signing is confirmed before it happens. The final signature is applied by the psychologist, using a signature they have uploaded.
7 Export / print ~seconds
As soon as you sign, the finished report reopens read-only so you can produce the final document right away β use π¨ Print / Preview or β€ Export Word at the top.
Signing does not delete the report. It stays available: a psychologist finds it under π Signed reports (a searchable history you can reprint from), and it can also be opened from its appointment. Open it anytime to Print or Export again β it just can't be edited.
You are the clinician who meets the client and starts the case. Your dashboard has your own appointments, a β To review & sign queue, and the assessment board.
Attend the appointment and click it on your calendar. For a SimplePractice appointment you get a choice β open it in SimplePractice, or Start evaluation intake right here (you don't leave the app). Then do the intake β type it, drop a Word/Text file, or paste it. Name, date of birth, parents, and address flow into the report header.
Choose the assessments the client will complete on the assessment board. This starts the coordination and notifies the front desk.
When the drafter finishes the write-up, it lands in your β To review & sign queue. Read it, then apply your first signature β or Request changes with a note to send it back to the drafter.
Your signature routes the report to the psychologist for the final signature. You do not apply the final signature yourself.
The clinician dashboard: three tabs β Appointments, To review & sign, and Assessments. Here a finished draft is waiting for the clinician's first signature.
Your calendar shows your own appointments. Paste your personal SimplePractice feed under Settings β Account β Your calendar (private to you). The filter bar above the calendar searches across all dates β by name, by a from/to date range, and by status (waiting for intake / cases) β and shows the matches as a list; Clear returns to the calendar.
Your appointments (Month view β also Week and List). Click a SimplePractice appointment and choose Start evaluation intake to begin the case here.
Guide: Coordinator (front desk)
Your home screen is Appointments. You have three views β Week, Month, and List β plus a Patients lookup and the Assessments board.
Because you assign everyone's time, your calendar shows the whole practice's appointments β the combined feeds of every clinician. Each clinician, by contrast, sees only their own.
β Book in SimplePractice β β opens SimplePractice in a new tab. All booking is done there; the app reads it back and shows it on the calendar (clicking an empty slot in Week/Month also opens SimplePractice).
Click an appointment to see its details. Once an evaluation has started on it, the appointment shows a small π and a discreet notice ("being processed / delivered for review / completed"), and it can no longer be edited or cancelled β this protects work in progress.
Patients β search by name or record ID to see a person's history.
List view shows every appointment in order.
The assessment board
Once a clinician chooses a client's assessments, they appear on your Assessments board. There you send each one out, mark it Sent, then mark it Completed as results come back β search by client and tick each one off. When every assessment meant to be sent is completed, the drafter is notified automatically. You get a notification (bell, and email if configured) at each hand-off.
The assessment board β one card per active case. Each study can be sent, then marked Sent and Completed; search by client and filter by status. Studies can be added or removed, and every study meant to be sent being completed notifies the drafter.
Guide: Drafter
Your dashboard has two tabs: π My queue β the evaluations waiting to be worked β and π Appointments β every clinician's schedule, so you can see what's coming. You do the full write-up; the clinician signs first and then the psychologist applies the final signature. You are notified (bell, and email if configured) when a case's assessments are all in and it's ready to draft.
The Appointments tab. You see all clinicians' appointments (color-coded by person). An appointment marked β³ waiting for intake isn't a case yet β the clinician hasn't done the intake. Once they do, it lands in your My queue to claim and draft; on the calendar it stops showing "waiting" and you can open it directly. You don't need a calendar of your own for this. The filter bar above the calendar searches across all dates β by name, by a from/to date range, and by status (waiting for intake / cases) β and lists the matches; Clear returns to the calendar.
Open a pending evaluation (or claim one from the queue).
Upload the test reports in the Test reports panel (drag & drop PDFs).
Press β¨ Generate report and wait for the draft.
Review and correct everything β verify the scores against the originals, fix any misreads, write/adjust the clinical summaries, set the diagnoses, and check the recommendations.
Press Save as often as you like (it also saves automatically). When finished, press Submit for review to hand it to the psychologist.
Save vs Submit:Save keeps your work but leaves the evaluation with you. Submit for review moves it forward β first to the clinician for the first signature, then to the psychologist for the final signature. You cannot sign.
The drafter's dashboard / work queue.
Guide: Psychologist
You can do everything the others do, plus you are the only one who applies the final signature. A report reaches you after the clinician has reviewed it and applied the first signature; you review it and finalize it.
β Review queue β evaluations that are ready for your final signature (clinician-signed), plus any submitted for review or sent back for changes, appear here. Open one to read it.
π Signed reports β your searchable history of finished, signed evaluations. Open any one to reprint or re-export it (read-only); repeat visits for the same patient are grouped together.
β Sign (final) β applies your final signature and locks the report. You must have uploaded your own signature first (Settings β Account β Your signature); each psychologist uses their own, and only you can apply yours.
Request changes β instead of signing, send it back to the drafter with a note about what to fix.
After you sign, the report reopens read-only with π¨ Print / Preview and β€ Export Word ready to use. It is not deleted β it moves to π Signed reports, your searchable history of finished evaluations (also reachable from the appointment), so you can reopen and reprint/export it whenever you need. Repeat visits for the same patient are grouped together there.
Drop the QGlobal / MHS reports here (PDF or Word). Several at once is fine. They are the documents the app reads scores and graphs from. Remove one with the β; if you remove a document, everything derived from it is removed too.
β¨ Generate report
Reads the scores and graphs from the uploaded reports and writes the full evaluation. Run it again any time β it re-writes the report from the current documents and scores. It runs on the server, and the draft is read-only until it finishes. π Read scores (AI) re-reads just the numbers; β» Reset & re-scan graphs re-reads the images.
Only the tests you actually administered appear. The report includes a section for each test that has data (an uploaded report, scores, or a written summary); tests with nothing entered are left out automatically, so you won't get empty placeholder sections.
Score tables & attention flags
Each test's scores appear as a typed table (like the clinic's finals). Cells are editable β correct any misread value, scale name, or classification. The β flags mark concerning values (red = strongest, amber = milder) and exist only on screen; they never export. What decides a flag is configured per study in Settings β Clinical flags.
Summary of Evaluation β disorder category
The summary opens with the standard sentence "β¦meets the clinical diagnostic criteria for a disorder of ___." A picker above the paragraph fills that in: use the + Add categoryβ¦ drop-down to add a category (neurodevelopment, mood, attention, anxiety, β¦), and it appears as a removable tag β add more than one for a combined phrase like "neurodevelopment/mood", or remove one with its β. For a category not in the list, type it in the otherβ¦ box and press Enter. The sentence updates itself. The specific diagnosis still goes in the Diagnosis table below; this is only the broad category word, and you can still edit the paragraph text directly at any time.
Diagnosis picker & table
The DSM-5 / ICD-10 picker sits next to the diagnosis table it fills. Check a box to add that diagnosis; uncheck to remove it. Use οΌ Add diagnosis for anything not in the list, and the β to remove a row. Checking a box only edits the document β it does not call the AI. Recommendations are rebuilt from these diagnoses the next time you press Generate.
Recommendations
Built from the diagnoses using the clinic's standard wording, plus any case-specific items. Edit any line, remove one with β, or use + Add recommendation. Use β₯ to turn a line into indented sub-text under the item above it β for a note or a list of links that belong to a recommendation β and β€ to promote it back to a normal bulleted item. Sub-text lines export without a bullet, indented under their recommendation.
Header & signature
The identity block (name, DOB, dates, clinician) is pre-filled from the patient's appointment record β not read off the documents by the AI β so the name, date of birth and evaluation date are authoritative from the start. It stays editable while the report is a draft: a green check confirms it matches the record, and a flag warns if an edit drifts from it. On a signed report these fields become read-only (see the Psychologist guide to reopen one). The signature line fills with the signing psychologist's uploaded signature once the report is signed.
Settings
Open the account menu (top right) β β Settings. The tabs you see depend on your role.
Account (everyone)
Shows who you are signed in as (everyone signs in with Microsoft β there is no separate app password). This is also where you set Your calendar (your own SimplePractice iCal URL, private to you) and, for psychologists, upload Your signature β the image is applied to a report only when you sign it, and each psychologist manages their own.
The Account tab. Psychologists upload their signature here.
Your calendar (SimplePractice iCal) β what it is and how to connect it
A calendar link (iCal URL) is a private web address for your SimplePractice calendar. Pasting it into the app under Settings β Account β Your calendar lets the app show your appointments (read-only) so you can attend them and start the intake. It is one-way β the app only reads it and never changes anything in SimplePractice β and the link stays encrypted and private to you.
How to get your iCal link in SimplePractice:
Sign in to SimplePractice and open your Calendar.
Click the βοΈ gear (Calendar settings) at the top-right of the calendar.
Click Calendar sync and policies.
Under Calendar URL, click Copy link, then paste it into Settings β Account β Your calendar in the app and press Save my calendar feed.
The Account tab has an Open SimplePractice calendar β button that takes you straight to the right page. If your SimplePractice Settings menu has no "Scheduling and inquiries" item, that's fine β use the calendar βοΈ gear instead; it works from any account that has its own calendar.
Who needs to do this: each clinician connects their own SimplePractice calendar once, so their appointments appear. Front-desk and drafter roles don't have their own SimplePractice calendar β they see everyone's appointments without connecting anything. An appointment shows only the client's initials until a clinician does the intake; the full name (and name search) appear once the intake is done.
Email (admin)
Configures the shared mailbox the app uses to send handoff alerts to staff (encrypted; body is PHI-minimal, by chart # only). Each person's own calendar feed lives in Account, not here.
Clinical flags (admin)
Configure, per study, the score ranges that raise an attention flag: pick the study, set the direction (which end is concerning), the Warn and Alert cutoffs, and optionally an age band. The app ships with faithful, sourced defaults for every instrument (shown as a suggestion you can change; βΊ Norm restores one, βΊ Reset all restores everything).
Per-study thresholds. Your values take priority; the norm is shown as a hint.
Users (admin)
Add someone by their Microsoft email and check the roles they should have (Psychologist / Receptionist / Drafter). Everyone signs in with Microsoft.
FAQ & troubleshooting
Where is my report after I sign it? Signing never deletes it. It reopens read-only right away (Print / Export are at the top). To find it later, a psychologist opens π Signed reports β a searchable history of every finished evaluation, with repeat visits grouped per patient; it can also be opened from its appointment (and reception can find it with the "completed" filter). Open it anytime to print or export again β it just can't be edited.
A score looks wrong. Click the cell and correct it. Scores from a file tagged read by AI are the likeliest to be misread. Always compare the tables to the original reports before signing.
The graphs didn't appear / are under the wrong test. Use β» Reset & re-scan graphs, or each graph card's dropdown to place it under the right test.
A graph is missing from the printed report, or one shouldn't be there. Each test prints only the vendor pages its finalized reports use; the rest show dimmed with οΌ Include. Click οΌ Include or β In report on a card to change it. A graph not placed with any test prints only after you include it.
Generate says the report didn't finish. The message gives the reason. If the server restarted or the AI service was busy, press β¨ Generate report again. The draft you had before is still there.
I can't edit an appointment. Once an evaluation has started on it, the appointment locks (π) so work in progress isn't disturbed.
The Sign button says I have no signature. Go to Settings β Account β Your signature and upload yours; only then can you sign.
I checked three Autism levels by accident. Each level is independent β uncheck the ones you don't want, or remove the row with β.
Did my work save? Yes β the draft saves automatically, and a "Saved" indicator confirms it. If a save ever fails you'll see a "β Not saved" warning.
My appointments don't show on the calendar. Connect your SimplePractice calendar first: Settings β Account β Your calendar, then paste your iCal link (see "Your calendar (SimplePractice iCal)" under Settings for the exact steps). Each clinician connects their own once.
Why do some appointments show only initials? SimplePractice sends the calendar with the client's initials until an intake is done. Once a clinician completes the intake, the appointment becomes a case and shows the full name β and only then can you find it by name.
I can't find a client to draft. A client appears in the app once an intake has been entered for them here. Until a clinician does the intake, there's nothing to draft yet β the drafter queue fills up as intakes are completed.
Generating the draftβ¦
Extract intake data
Select template (gender + prognosis)
Generate Background (CB-PA format)
Populate header
Map test sections
Assign DSM-V / ICD-10 diagnosis
Assemble document
Evaluation draft
β The draft is editable. Click any section to correct, remove, or add text before exporting.