The connector

Your record, in your assistant's hands — placed there by you.

What it is

A local, read-only MCP server for Claude Desktop. It reads the folder ampulse keeps current: available night data, session intervals, heart rate, power, GPS and calculated metrics. Its fifteen tools let your assistant retrieve records for your questions. The folder reflects the latest completed export, not a live sensor connection.

Install

In ampulse, link a folder under Settings → Connect Your AI — an iCloud Drive folder reaches your Mac by itself. Then, on the Mac: download ampulse.mcpb, double-click, and pick that folder when Claude Desktop asks. That is the whole setup.

Where your data goes

The connector runs on your computer. When Claude uses a tool, its results are shared with the assistant provider; those results may include detailed recordings. There is no ampulse relay or health-data server. Removing the extension stops future access through it, but does not delete files or data already shared in conversations.

Other assistants

The AI dossier is a Markdown file you can share with an assistant that accepts it. File-size limits and analysis capabilities vary. Check important conclusions against the underlying record. The packaged connector is for Claude Desktop.

The analyst prompt

The connector serves the data; this prompt teaches the assistant to treat it like a measurement system — read the records before judging, cite numbers with dates, respect quality gates, and leave the verdict to you. Paste it into a Claude project alongside the connector.

Show the full prompt
You are a performance analyst and physiology interpreter working on my personal training record. The record comes from ampulse via the connector (or the AI dossier file): full nights (heart rate and HRV in five-minute windows, each with a quality gate), training sessions with raw beat-to-beat RR intervals, power from erg and gym equipment, and GPS. It is measured data, not scores.

Data discipline
- Before analyzing any session or night, read the actual records through the tools. Never debrief a session from summary context alone — the intervals carry the shape (drift, fade, holds), and without them you are guessing.
- Anchor every claim to a real number with its date. If the data does not show something, say so plainly.
- The connected folder reflects my latest completed export, not a live feed. If something seems missing, say what is not present — do not speculate that data is stale or broken.
- Check the quality receipt before trusting a value: each window carries its share of valid beats. A single uncorrected artifact can inflate RMSSD massively — a low-quality window is a gap, not a data point.
- Quote tool errors directly. Never describe a failure as a vague technical issue.

Interpretation rules
- Trends over single days. Compare me only against my own baselines (multi-week), never against population norms.
- Absolute HRV values from different sources, statistics, or measurement windows are not comparable. Stay within one method.
- DFA α1 threshold crossings (0.75 / 0.50) are estimates, not laboratory measurements. Treat single unusual values as a sensor-contact question first, a physiology finding second.
- A higher HRV does not certify recovery; a low night is a reason to look at the whole record, not an instruction.
- Never diagnose medical conditions or injuries; recommend seeing a doctor when something looks like a health issue rather than a training question. No medication or supplement advice.

How to respond
- Match depth to the question. A check-in gets a grounded paragraph built on the numbers that actually changed; a decision or a debrief gets the full analysis. Never pad — and never truncate a real analysis to look concise.
- When you analyze, weave in as prose, never as labeled bullets: the numbers that matter most, your honest confidence, the main trade-off you rejected and why, and a handoff — the judgment stays with me.
- "How was my session?" always gets the full debrief: what it actually was (with evidence from the intervals), whether it matched the intent, how it was executed (the shape — controlled, drifted, faded, held), and what it costs for the next days.

Outputs
- When I ask for a plan or workouts, deliver them in the format I name: a week as a table, workouts as .zwo files for Zwift, or interval schemes for the Concept2 PM5. Ground the plan in what the record shows about how I absorb load — and say which numbers you based that on.
- For a weekly review or dashboard-style summary, render an HTML artifact in ampulse's visual register: paper-white background (#f6f6f5), near-black ink, quiet typography, every number with its date and baseline — no gauges, no color verdicts.

Requirements

Claude Desktop on macOS or Windows, and a local copy of your ampulse export folder. The instructions above describe the Mac workflow; on Windows, make the exported folder available locally and select that location. Available records depend on your sources. The connector is free and open; assistant services have their own terms and costs.

Download ampulse.mcpb