Exist

Exist API integration with managed OAuth. Read health and fitness tracking data, retrieve correlations and insights, manage attribute ownership, and track we...

Jay

@hith3sh

Install

$ openclaw skills install @hith3sh/exist

Exist

Exist

Access health and fitness tracking data from chat -- retrieve tracked attributes, discover correlations between metrics, get AI-generated insights, and manage data ownership. Powered by ClawLink for hosted OAuth.

Setup in 3 Steps

Step 1: InstallStep 2: Pair AccountStep 3: Connect Exist
InstallPairApp-specific connection GIF coming soon
Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect Exist

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   Exist API      │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

// 1. Get your profile
clawlink_call_tool({ tool: "exist_get_user_profile", parameters: {} })

// 2. See your tracked attributes
clawlink_call_tool({ tool: "exist_get_attributes_with_values", parameters: {} })

// 3. Discover correlations
clawlink_call_tool({ tool: "exist_get_correlations", parameters: {} })

Authentication

ClawLink handles OAuth with Exist. No API keys needed. Connect at claw-link.dev/dashboard?add=exist. Granted OAuth scopes determine which attribute fields are returned.

Connection Management

// List connections
clawlink_list_integrations()

// Verify
clawlink_call_tool({ tool: "exist_get_user_profile", parameters: {} })

Security & Permissions

  • Read tools are safe and require no confirmation
  • Write tools (acquire/increment/release ownership) require confirmation
  • Releasing ownership is high-impact and stops data flow for that attribute

Tool Reference

Profile & Discovery

ToolDescriptionMode
exist_get_user_profileGet authenticated user profile, timezone, and preferencesRead
exist_get_attribute_templatesBrowse available attribute templates before creating dataRead
exist_oauth2_authorizeConstruct OAuth2 authorization URL for Exist.ioRead

Attribute Reading

ToolDescriptionMode
exist_get_user_attributesList user attributes without values (metadata catalog)Read
exist_get_attributes_with_valuesGet attributes with current values and historyRead
exist_get_owned_attributesList attributes owned by your serviceRead
exist_get_averagesGet weekly averages with daily breakdowns (Mon-Sun)Read

Insights & Correlations

ToolDescriptionMode
exist_get_insightsGet AI-generated insights about patterns in tracked dataRead
exist_get_correlationsDiscover statistical relationships between tracked attributesRead

Attribute Writing

ToolDescriptionMode
exist_acquire_attribute_ownershipAcquire ownership of attributes to write dataWrite
exist_increment_attribute_valuesIncrement attribute values by a delta (counters only)Write
exist_release_attribute_ownershipRelease ownership, stopping data flow for that attributeWrite

Code Examples

Example 1: Explore your tracked data

// Get profile and timezone
const profile = await clawlink_call_tool({
  tool: "exist_get_user_profile",
  parameters: {}
});

// Get attributes with values
const attrs = await clawlink_call_tool({
  tool: "exist_get_attributes_with_values",
  parameters: {}
});

// Get weekly averages
const averages = await clawlink_call_tool({
  tool: "exist_get_averages",
  parameters: { include_historical: true }
});

Example 2: Discover correlations and insights

// Find correlations between metrics
const correlations = await clawlink_call_tool({
  tool: "exist_get_correlations",
  parameters: {}
});

// Get AI-generated insights
const insights = await clawlink_call_tool({
  tool: "exist_get_insights",
  parameters: {}
});

Example 3: Write tracking data

// Acquire ownership of a step count attribute
await clawlink_call_tool({
  tool: "exist_acquire_attribute_ownership",
  parameters: {
    attribute_names: ["steps"]
  }
});

// Increment step count
await clawlink_call_tool({
  tool: "exist_increment_attribute_values",
  parameters: {
    data: [{ date: "2026-06-08", attribute: "steps", value: 500 }]
  }
});

Discovery Workflow

  1. Call clawlink_list_integrations to confirm exist is connected.
  2. Call clawlink_list_tools --integration exist to see the live catalog.
  3. Use clawlink_search_tools({ query: "correlation", integration: "exist" }) to find specific tools.

Execution Workflow

READ (safe):     get_user_profile → get_attributes_with_values → get_correlations → get_insights
WRITE (confirm): acquire_attribute_ownership → increment_attribute_values
DELETE (high):   release_attribute_ownership

Notes

  • OAuth scopes control which attribute fields are visible -- missing fields indicate insufficient scopes
  • Increment does not work with string, scale, or time-of-day attributes
  • Releasing ownership stops data flow permanently for that attribute
  • Use the profile timezone when interpreting date-based attributes

Error Handling

Status / ErrorMeaning
401 UnauthorizedOAuth token expired -- reconnect at dashboard
403 ForbiddenInsufficient OAuth scopes for requested attributes
404 Not FoundAttribute template or attribute does not exist
422 UnprocessableInvalid attribute type for increment operation

Troubleshooting

Tools Not Visible

  • Start a fresh OpenClaw chat to reload plugin catalog
  • Call clawlink_list_integrations to confirm pairing

Missing Attribute Data

  • Check granted OAuth scopes during connection
  • Some attributes require specific integrations to be connected in Exist first
  • Use exist_get_attribute_templates to verify available attributes

Resources


Powered by ClawLink -- an integration hub for OpenClaw

ClawLink Logo

Related skills