fulcra-context

What This Skill Does

The fulcra-context skill provides OpenClaw AI agents with unprecedented situational awareness by integrating the Fulcra Life API. By connecting your personal data streams—including biometrics, sleep patterns, physical activity, geolocation, and calendar events—this skill transforms an AI from a passive assistant into a proactive partner. It creates a bridge between your physical well-being and your digital workspace, allowing the agent to understand not just what you are working on, but how your current physiological and environmental state should influence that work.

Installation

To integrate fulcra-context into your OpenClaw environment, you have three primary paths:

1. MCP Server (Recommended): This is the cleanest integration. For Claude Desktop, add the provided configuration to your claude_desktop_config.json file. It utilizes the secure Fulcra hosted MCP server, which handles OAuth2 authentication for you.
2. Direct API Access: If you prefer manual management, generate an access token via the Fulcra Portal and append it to your openclaw.json file under skills.entries.fulcra-context.apiKey.
3. Python Client: For custom automation workflows, install the fulcra-api package via pip. This method is ideal for developers who need to build complex analytical pipelines using the metric_samples and calendar_events methods. Note that the Python client requires manual token persistence management if you are running background tasks.

Use Cases

• Optimized Workload Management: If the agent detects poor sleep quality via the SleepStage metric, it can automatically reschedule high-focus tasks or suggest a lower-intensity workflow for the morning.
• Stress Mitigation: By monitoring heart rate variability (HRV) trends, the agent can proactively suggest taking a break or shifting to non-meeting tasks during periods of detected physiological stress.
• Context-Aware Briefing: Your agent can check your location and calendar simultaneously to provide tailored briefings; for instance, it won't suggest home-based chores while you are at the office, or it might remind you of a commute during travel days.

Example Prompts

1. "Based on my sleep data from last night, do you think I should prioritize deep work this morning or handle administrative tasks?"
2. "I'm feeling a bit overwhelmed. Check my heart rate trends over the last 4 hours and tell me if I should take a walk before my next meeting."
3. "Look at my calendar and current location—what is the most efficient way to manage my tasks for the rest of the day?"

Tips & Limitations

Always ensure your Fulcra consent tokens are active; the default session lasts approximately 24 hours. If using the Python client, implement the provided token management script to automate refreshes and avoid manual re-authentication. Remember that the agent only has read-only access to your data. Privacy is managed at the source through the Fulcra platform, meaning you retain full control over what categories of data are exposed to the AI at any time.