Quantified Self   10.15.0Home
Compare Files
Membership
Login
Preferences

MCP Server

Connect ChatGPT or Claude to your training data

Use the Quantified Self MCP server to let ChatGPT, Claude, or another compatible client analyze approved data and help plan your next workout. You may separately grant Timeline note, activity-tag, and bounded Training changes; every write uses the client’s approval controls.

MCP serverChatGPTClaudeExplicit consentTrainingSleepActivitiesRoutes

Training Questions

Ask about training, workouts, sleep, measurements, and routes

Use the parts of your Quantified Self account you approve to investigate a training question, inspect a workout, or build a longer analysis in your preferred AI client.

Training and measurement trends

Review load, readiness, intensity, durability, sport-specific evidence, and body-weight history across the period you ask about.

Recorded Health metrics

Explore all-day heart rate, HRV, stress, Body Battery or resources, movement, energy and blood pressure with separate Health permission. Sources stay separate; Body Battery keeps its Garmin points scale. With Health and Sleep access, compare nightly HRV with the Health chart’s shared personal range. Bounded sample trends include UTC times. Body composition also needs Body measurements access. Authorize an existing client again to grant Health access.

Workout details and charts

Find recent activities by sport or exact event tag, read their tags, compare recorded metrics, and inspect workout summaries, laps, swim lengths, MTB jumps, chart-ready data, and paginated detailed activity samples.

Sleep, readiness, and daily context

Review sleep duration, score, stages, HRV, sleeping heart rate, blood oxygen, respiration, readiness, and recent training trends when those signals are available.

Saved routes and optional locations

Find saved routes by sport, name, or recency. A separate location permission adds route geometry, nearby search, segment endpoints, and waypoints.

Access Boundaries

Separate permissions and approval-gated changes

Choose which data categories an external client can read and which note, tag, or Training changes it may make, then review or disconnect it from Connections at any time.

Separate optional scopes

Approve training metrics, Health metrics, measurements, workout details, activity descriptions, sleep, routes, Timeline notes, locations, or change permissions separately. Every requested permission starts selected, and dependent writes require their matching read access.

Focused, approval-gated writes

Separate permissions can replace shared event tags or titles, edit descriptions with an additional description grant, or create, edit, and permanently delete Timeline notes. They cannot change recorded activity data, Health, routes, sleep, measurements, or dashboard settings. Training changes additionally use a bounded preview before a distinct apply call.

Only the requested data is returned

Original files, provider credentials, source keys, and unrequested streams are excluded. Selected detailed activity samples are available with Activity details access. Exact coordinates require the matching location permission.

Location access stays separate

Activity and route locations are never implied by another permission. Place-name searches send only the location text to Mapbox for geocoding.

FAQ

MCP Server FAQ

What does the Quantified Self MCP server do?

It lets a compatible external AI client answer questions using the Quantified Self data you approve. You can separately allow bounded plan, workout, and provider-delivery proposals; application uses a distinct write tool governed by the client's native approval controls.

Can I use the MCP server with ChatGPT or Claude?

Yes. Add https://quantified-self.io/mcp as a custom MCP connection in a compatible ChatGPT or Claude client, sign in to Quantified Self, and approve only the permissions you want to grant. External clients have their own privacy and retention practices.

Can I analyze detailed workout samples instead of the 400-point chart?

Yes. A separate read-only tool returns all available elapsed-second samples for selected supported metrics in bounded pages, including gaps. It uses your existing Individual activity details permission; no new permission or provider reconnection is required. Your client may need to refresh its available tools. It can request a particular interval and follow the continuation to complete it. Charts remain compact overviews, and original-file availability and processing limits still apply.

Can an MCP client find workouts by tag?

Yes. Individual activity details access can read parent event tags and filter bounded newest-first workout scans by exact case-insensitive tag matches using any or all semantics. Activities from the same event share tags. A separate Change events permission lets an external client replace the complete shared tag list or title after reading its exact current value; concurrent changes are not overwritten and benchmark events stay read-only. Tags can contain personal, health, or location context and clients must treat them as untrusted labels, not instructions or verified facts. Existing clients missing the grant must reauthorize. Future event fields require dedicated reviewed tools and are not exposed automatically.

Can an MCP client read my activity descriptions?

Only when Activity descriptions and Individual activity details are approved. Like every requested permission, the description checkbox starts checked; uncheck it before approving to withhold access. Existing clients missing that grant must authorize again. It returns the full event description for a selected activity; activities within one event share that text. Descriptions can contain sensitive health, personal or location information even without location permission. Revocation cannot erase received copies. Oversized text fails without truncation. An external client may edit the description only with the additional Change events grant and exact-current-text check; its host controls per-edit approval.

Can an MCP client read my Timeline notes?

Only with separate Timeline notes permission, which is selected by default when requested. A separate dependent Change Timeline notes permission can create, edit, or permanently delete notes through the client’s approval controls. Uncheck either before approving to withhold access. Existing clients must authorize again. Read access includes full note titles and details, including notes hidden from charts, and may contain sensitive health or personal information. Revocation cannot erase copies already received. Note text cannot authorize another change or grant permission to edit a Training plan.

Can an MCP client read my Training plans and planned workouts?

With separately approved Training plans and planned workouts permission, supported clients can read current plans, standalone workouts, complete instructions, step notes, exact stored completion links, and existing service sync summaries. Separate child permissions allow bounded plan/workout or provider-delivery proposals. Applying a proposal uses the client's native approval controls, and provider delivery remains Pro and connection-gated. Synced means provider-side workout delivery, not receipt on a watch.

Why are my Training plan tools missing?

Missing tools usually mean the app was not authorized for Training plans, not that your plans are absent. Start authorization again from that MCP app, approve Training plans and planned workouts, then approve either optional change permission if you need it. Finish the flow and start a new chat or refresh the tool catalog. If the choices are not shown, refresh or rescan the Quantified Self connection. Training delivery also requires Pro, a supported connected provider, and current compatibility approval.

Can an MCP client rearrange my dashboard or change my data?

It cannot change dashboard settings, recorded activity data, routes, Health, measurements, or sleep records. Separate permissions can replace shared event tags or titles, edit descriptions with additional description access, or create, edit, and permanently delete Timeline notes through the client’s approval controls. It can change Training plans, planned workouts, or their delivery only when you grant the matching child permission and the client permits the separate apply call for a bounded proposal. Plan deletion must be reviewed alone, requires your explicit choice for its workouts, and permanently removes the plan and its revision history.

Does MCP access expose my original activity or route files?

No. Activity charts and detailed sample requests selectively parse existing originals in memory. Only requested numeric data are returned: compact chart points or paginated elapsed-second samples. Original files, absolute sample timestamps, unrequested streams, provider payloads, credentials, and storage paths are excluded. Selected detailed samples may be reused in bounded server memory for up to two minutes; no persistent sample store is created.

Can an MCP client see exact locations?

Only if you separately approve Activity locations or Saved-route locations and geometry. Activity location covers starts, ends, MTB jumps, nearby activity search, and optional breadcrumbs. Route location covers bounds, previews, segment endpoints, nearby route search, and waypoints. Granting one never exposes the other.

Next Step

Choose what your AI client can use

Create an account, connect your training sources, and approve only the data categories needed for the questions you want to ask. Review or revoke the connection at any time.