athenahealth connector for AI agents

Tools your clinical agent reaches for on athenahealth, scoped per user.

CALL ANY TOOL

55 tools for clinical records in athenahealth, all read-only: search and read FHIR patients, conditions, allergies, medications, observations, diagnostic reports, encounters, appointments, care plans, immunizations, and clinical documents.

athenahealth_allergy_intolerance_read

Read allergy intolerance

Retrieve one athenahealth FHIR AllergyIntolerance resource by its logical ID. Returns the AllergyIntolerance resource: allergies and intolerances recorded on a patient's chart, with substance code, clinical status, reaction, and criticality. Use this when you already have the allergy ID. Use athenahealth_allergy_intolerance_search to find allergies.

Parameters

Name

Type

Required

Description

allergy_intolerance_id

string

Required

Logical ID of the AllergyIntolerance resource (the id element, without the AllergyIntolerance/ prefix).

athenahealth_allergy_intolerance_search

Search allergy intolerance

athenahealth_appointment_read

Read appointment

athenahealth_care_plan_read

Read care plan

athenahealth_care_plan_search

Search care plan

athenahealth_condition_read

Read condition

athenahealth_condition_search

Search condition

Search athenahealth FHIR Condition resources (conditions) available to the signed-in clinician. Returns a FHIR Bundle of Condition entries: problems and diagnoses (problem-list items, encounter diagnoses, health concerns), with code, clinical and verification status, category, and onset; follow the cursor in the Bundle's next link to page. Use this to find or list conditions. Use athenahealth_condition_read when you already have the condition ID. athenahealth requires at least one of: Encounter ID; Patient ID; Condition ID. If the result has a next link, use athenahealth_next_page to get more.

Parameters

Name

Type

Required

Description

_count

integer

Optional

Maximum number of resources to return per page. The server picks a default when omitted.

_id

string

Optional

Logical ID of a specific Condition to match. Returns a Bundle with that one resource; use athenahealth_condition_read to fetch it directly.

_lastUpdated

string

Optional

Only return conditions last updated on or around this date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

ah_practice

string

Optional

athenahealth practice to scope the search, as Organization/a-1.Practice-<practiceId>. Optional for clinician sign-in; athenahealth requires it for practitioner identifier searches.

category

string

Optional

Condition category as system|code, e.g. http://terminology.hl7.org/CodeSystem/condition-category|problem-list-item, http://terminology.hl7.org/CodeSystem/condition-category|encounter-diagnosis, or http://hl7.org/fhir/us/core/CodeSystem/condition-category|health-concern.

code

string

Optional

Condition code as system|code or code, e.g. an ICD-10-CM or SNOMED CT code.

cursor

string

Optional

Paging cursor for the next page. Copy the cursor query parameter value from the next link (Bundle.link with relation next) of the previous page's response.

encounter

string

Optional

FHIR ID of the Encounter the conditions belong to, or an Encounter/<id> reference.

patient

string

Optional

athenahealth FHIR ID of the patient whose conditions to return (the Patient.id from athenahealth_patient_search or athenahealth_patient_read), or a Patient/<id> reference.

athenahealth_device_read

Read device

athenahealth_device_search

Search device

athenahealth_document_reference_read

Read document reference

athenahealth_document_reference_search

Search document reference

Search athenahealth FHIR DocumentReference resources (document references) available to the signed-in clinician. Returns a FHIR Bundle of DocumentReference entries: clinical notes and documents, with type, category, date, author, status, and attachment links to the document content; follow the cursor in the Bundle's next link to page. Use this to find or list document references. Use athenahealth_document_reference_read when you already have the document reference ID. athenahealth requires at least one of: Patient ID; Document Reference ID. If the result has a next link, use athenahealth_next_page to get more.

Parameters

Name

Type

Required

Description

_count

integer

Optional

Maximum number of resources to return per page. The server picks a default when omitted.

_id

string

Optional

Logical ID of a specific DocumentReference to match. Returns a Bundle with that one resource; use athenahealth_document_reference_read to fetch it directly.

_lastUpdated

string

Optional

Only return document references last updated on or around this date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

ah_practice

string

Optional

athenahealth practice to scope the search, as Organization/a-1.Practice-<practiceId>. Optional for clinician sign-in; athenahealth requires it for practitioner identifier searches.

author

string

Optional

Reference to the document author, as Practitioner/<id> or Organization/<id>.

category

string

Optional

Document category, e.g. clinical-note (US Core clinical notes), optionally as system|code (http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category|clinical-note).

cursor

string

Optional

Paging cursor for the next page. Copy the cursor query parameter value from the next link (Bundle.link with relation next) of the previous page's response.

custodian

string

Optional

Reference to the Organization that maintains the document, as Organization/<id>.

date

string

Optional

Filter by the document date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

encounter

string

Optional

FHIR ID of the Encounter the document references belong to, or an Encounter/<id> reference.

patient

string

Optional

athenahealth FHIR ID of the patient whose document references to return (the Patient.id from athenahealth_patient_search or athenahealth_patient_read), or a Patient/<id> reference.

type

string

Optional

Document type as system|code, e.g. a LOINC document code.

athenahealth_family_member_history_read

Read family member history

athenahealth_family_member_history_search

Search family member history

athenahealth_immunization_read

Read immunization

athenahealth_immunization_search

Search immunization

Search athenahealth FHIR Immunization resources (immunizations) available to the signed-in clinician. Returns a FHIR Bundle of Immunization entries: administered or recorded vaccines, with vaccine code, status, occurrence date, lot number, and performer; follow the cursor in the Bundle's next link to page. Use this to find or list immunizations. Use athenahealth_immunization_read when you already have the immunization ID. athenahealth requires at least one of: Patient ID; Immunization ID. If the result has a next link, use athenahealth_next_page to get more.

Parameters

Name

Type

Required

Description

_count

integer

Optional

Maximum number of resources to return per page. The server picks a default when omitted.

_id

string

Optional

Logical ID of a specific Immunization to match. Returns a Bundle with that one resource; use athenahealth_immunization_read to fetch it directly.

_lastUpdated

string

Optional

Only return immunizations last updated on or around this date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

ah_practice

string

Optional

athenahealth practice to scope the search, as Organization/a-1.Practice-<practiceId>. Optional for clinician sign-in; athenahealth requires it for practitioner identifier searches.

cursor

string

Optional

Paging cursor for the next page. Copy the cursor query parameter value from the next link (Bundle.link with relation next) of the previous page's response.

date

string

Optional

Filter by the vaccine occurrence date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

encounter

string

Optional

FHIR ID of the Encounter the immunizations belong to, or an Encounter/<id> reference.

patient

string

Optional

athenahealth FHIR ID of the patient whose immunizations to return (the Patient.id from athenahealth_patient_search or athenahealth_patient_read), or a Patient/<id> reference.

status

string

Optional

Filter by immunization status: one of completed, entered-in-error, not-done. One of: `completed`, `entered-in-error`, `not-done`.

vaccine_code

string

Optional

Vaccine product code as system|code or code, e.g. a CVX code.

athenahealth_media_read

Read media

athenahealth_medication_dispense_read

Read medication dispense

athenahealth_medication_dispense_search

Search medication dispense

athenahealth_medication_request_read

Read medication request

athenahealth_next_page

athenahealth_observation_search

Search observation

Search athenahealth FHIR Observation resources (observations) available to the signed-in clinician. Returns a FHIR Bundle of Observation entries: vital signs, lab results, social history, and other measurements, with code, value, category, status, and effective date; follow the cursor in the Bundle's next link to page. Use this to find or list observations. Use athenahealth_observation_read when you already have the observation ID. athenahealth requires at least one of: Patient ID; Observation ID. If the result has a next link, use athenahealth_next_page to get more.

Parameters

Name

Type

Required

Description

_count

integer

Optional

Maximum number of resources to return per page. The server picks a default when omitted.

_id

string

Optional

Logical ID of a specific Observation to match. Returns a Bundle with that one resource; use athenahealth_observation_read to fetch it directly.

_lastUpdated

string

Optional

Only return observations last updated on or around this date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

ah_practice

string

Optional

athenahealth practice to scope the search, as Organization/a-1.Practice-<practiceId>. Optional for clinician sign-in; athenahealth requires it for practitioner identifier searches.

category

string

Optional

Observation category code, e.g. vital-signs, laboratory, social-history, survey, exam, or imaging.

code

string

Optional

Observation code as system|code, e.g. a LOINC code. Separate multiple codes with commas.

cursor

string

Optional

Paging cursor for the next page. Copy the cursor query parameter value from the next link (Bundle.link with relation next) of the previous page's response.

date

string

Optional

Filter by the observation date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

encounter

string

Optional

FHIR ID of the Encounter the observations belong to, or an Encounter/<id> reference.

patient

string

Optional

athenahealth FHIR ID of the patient whose observations to return (the Patient.id from athenahealth_patient_search or athenahealth_patient_read), or a Patient/<id> reference.

athenahealth_organization_read

Read organization

athenahealth_practitioner_read

Read practitioner

athenahealth_practitioner_search

Search practitioner

athenahealth_provenance_read

Read provenance

athenahealth_provenance_search

Search provenance

athenahealth_questionnaire_response_read

Read questionnaire response

athenahealth_questionnaire_search

Search questionnaire

athenahealth_service_request_read

Read service request

athenahealth_service_request_search

Search service request

Search athenahealth FHIR ServiceRequest resources (service requests) available to the signed-in clinician. Returns a FHIR Bundle of ServiceRequest entries: orders and referrals for services (labs, imaging, referrals), with code, category, status, intent, authored date, requester, and performer; follow the cursor in the Bundle's next link to page. Use this to find or list service requests. Use athenahealth_service_request_read when you already have the service request ID. athenahealth requires at least one of: Service Request ID; Patient ID. If the result has a next link, use athenahealth_next_page to get more.

Parameters

Name

Type

Required

Description

_count

integer

Optional

Maximum number of resources to return per page. The server picks a default when omitted.

_id

string

Optional

Logical ID of a specific ServiceRequest to match. Returns a Bundle with that one resource; use athenahealth_service_request_read to fetch it directly.

_lastUpdated

string

Optional

Only return service requests last updated on or around this date. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

ah_practice

string

Optional

athenahealth practice to scope the search, as Organization/a-1.Practice-<practiceId>. Optional for clinician sign-in; athenahealth requires it for practitioner identifier searches.

authored

string

Optional

Filter by the date the service request was authored. Prefix with a comparator (eq, gt, lt, ge, le) followed by a date in YYYY-MM-DD format, e.g. ge2024-01-01.

category

string

Optional

Service request category as a code or system|code, e.g. http://snomed.info/sct|108252007 (laboratory procedure).

code

string

Optional

Code of the requested service as system|code or code, e.g. a LOINC or CPT code.

cursor

string

Optional

Paging cursor for the next page. Copy the cursor query parameter value from the next link (Bundle.link with relation next) of the previous page's response.

encounter

string

Optional

FHIR ID of the Encounter the service requests belong to, or an Encounter/<id> reference.

patient

string

Optional

athenahealth FHIR ID of the patient whose service requests to return (the Patient.id from athenahealth_patient_search or athenahealth_patient_read), or a Patient/<id> reference.

performer

string

Optional

Reference to the Practitioner or Organization who performed or is to perform it, as Practitioner/<id> or Organization/<id>.

requester

string

Optional

Reference to the Practitioner who made the request, as Practitioner/<id>.

status

string

Optional

Filter by service request status: one of draft, active, on-hold, revoked, completed, entered-in-error, unknown. One of: `draft`, `active`, `on-hold`, `revoked`, `completed`, `entered-in-error`, `unknown`.

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// athenahealth tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["athenahealth"], toolNames: [
    "athenahealth_patient_search",
    "athenahealth_medication_request_search",
    "athenahealth_observation_search"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "List active medications for patient Maria Lopez" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["athenahealth"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "List active medications for patient Maria Lopez" }],
  tools,
});

// Execute the tool call with the user's vaulted athenahealth OAuth token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["athenahealth"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "List active medications for patient Maria Lopez" }],
  tools,
});

// Tool call runs with the user's vaulted athenahealth OAuth token
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["athenahealth"] }, pageSize: 100,
});

const agent = new Agent({
  name: "clinical_agent",
  model: "gemini-2.5-pro",
  instruction: "athenahealth tools scoped to this user",
  tools,
});

await agent.run("List active medications for patient Maria Lopez");

Try these prompts

Copy any prompt into your agent. Each maps directly to a athenahealth tool. Click to copy, paste into your agent, done.

Patients

Copy the prompt

Copied

Find the patient Maria Lopez born 1968-04-12.

Copy the prompt

Copied

List Maria Lopez's active problems and diagnoses.

Copy the prompt

Copied

What allergies are recorded for patient 8812?

Labs and vitals

Copy the prompt

Copied

Show the latest A1c results for patient 8812.

Copy the prompt

Copied

List vital signs recorded for patient 8812 this year.

Copy the prompt

Copied

Get the most recent lipid panel report for patient 8812.

Care and documents

Copy the prompt

Copied

List the encounters for patient 8812 this year.

Copy the prompt

Copied

Show the active care plan for patient 8812.

Copy the prompt

Copied

Find clinical notes from patient 8812's March visit.

SEE HOW AUTH WORKS

Each user signs in to athenahealth once, and Scalekit stores and refreshes their tokens. Credentials stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

athenahealth

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

athenahealth

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

athenahealth

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

athenahealth

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other healthcare connectors.

Support and Ops Teams

Meeting prep

Pulls agenda, participant context, and open action items before every meeting.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared athenahealth token looks fine in a demo. In production every chart lookup looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

athenahealth today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access athenahealth as the user or through a shared service account?

As the user. Each user signs in to athenahealth once, and Scalekit stores and refreshes their tokens. Every chart lookup the agent makes is attributed to that clinician in your audit trail, not a shared service account.

Where is the athenahealth OAuth token stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in athenahealth?

Yes. Every athenahealth tool is read-only, so the agent can search and read FHIR resources but cannot change chart data. Filter by tool name in listScopedTools to narrow it further, for example to athenahealth_patient_search and athenahealth_observation_search. Scalekit also enforces scope checks before every API call.

What happens when a user revokes athenahealth access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Which patients can the agent see in athenahealth?

Only the records available to the signed-in clinician. Each search tool returns the FHIR resources that clinician can access through SMART on FHIR, and athenahealth_next_page follows the next link when a search returns more than one page.