BloomicDevelopers

Bloomic SDK

Extend Bloomic with your own apps.

Pages for the clinic portal, integrations for your own systems, and agents. Write the code yourself, or build it with Claude Code, Codex or Gemini. Either way it runs on one SDK, with permissions the clinic controls.

$ bloomic app create todays-schedule --template page
✓ created · connected to your sandbox clinic

import { bloomic } from "@bloomic/sdk"

const user  = await bloomic.currentUser()
const today = await bloomic.appointments.list({ date: "today" })

render(<Schedule user={user} appointments={today} />)
$ claude
Build a portal page that shows today's schedule and lets
staff flag a patient for a call before their visit.

Reading the Bloomic SDK guides…
✓ created todays-schedule from the portal page template
✓ src/app.ts · lists today's appointments, flag creates a task
✓ asks for permissions: read appointments, create tasks
Run bloomic app dev to open it in the portal.
$ bloomic app create result-router --template integration
✓ created · connected to your sandbox clinic

import { bloomic } from "@bloomic/sdk"

bloomic.events.on("result.released", async (event) => {
  const result = await bloomic.results.get(event.id)
  await bloomic.tasks.create({ patient: result.patient, title: "Review result" })
})
$ codex
When a result is released, create a review task for the
clinician who ordered it.

Reading the Bloomic SDK guides…
✓ created result-router from the integration template
✓ subscribes to result.released · creates a task on each one
✓ asks for permissions: read results, create tasks
Run bloomic app dev to receive events from the sandbox.
$ bloomic app create day-planner --template agent
✓ created · connected to your sandbox clinic

import { bloomic, createAgent } from "@bloomic/sdk"

const agent = createAgent({
  tools: bloomic.mcpTools(),
  instructions: "Help the nursing team plan the day."
})

await agent.ask("Who needs a follow-up call this week?")
$ gemini
Build an assistant for the nursing team that can answer
"who needs a follow-up call this week" and create the tasks.

Reading the Bloomic SDK guides…
✓ created day-planner from the agent template
✓ uses Bloomic tools · asks a person before creating tasks
✓ asks for permissions: read patients, read results, create tasks
Run bloomic app dev to talk to it.

A page staff open inside the portal.

Code that runs on your systems and reacts to the clinic.

An assistant that uses the same capabilities as tools.

01Create an app

Start from a template with the CLI, or describe the app to Claude Code, Codex or Gemini and let it start from the SDK guides. Either way you develop against a sandbox clinic with generated data.

02Work with clinic data

Patients, appointments, results, notes and tasks through the SDK. Subscribe to events when things change. Agents get the same capabilities as tools.

03Add it to the portal

A clinic admin approves the permissions your app asks for and chooses who can see it. It appears under Custom Apps.