DocumentationMotionCommons · Developer preview

Connect Claude Code, Codex or another agent

Implemented locally · not verified in a live agent session

Agents act as you through the same capabilities as the app, under the same access rules.

Docs/Build extensions
Ask Claude

Connect Claude Code, Codex or another agent

Page Markdown

The complete guide, ready to copy or save as a Markdown file.

Download .md ↓

Sign in once

Enter the email address of an existing account, then the code from the email and, if two-factor is enrolled, your authenticator code. Only a revocable refresh token is stored, in a file readable by your user alone. The bridge never creates an account.

Run uv run --frozen hb agent logout to revoke the session on the server and delete the file.

sh
uv run --frozen hb agent login --api https://api.example.org

Add it to your agent

hb agent mcp is a stdio MCP server for Claude Code, Codex or any MCP host. In Codex, add the same command and arguments under [mcp_servers.limbstead] in ~/.codex/config.toml.

The bridge adds no tools and no privilege. Every call is verified as you, and the database’s access rules decide what each tool reads or changes.

json
{
  "mcpServers": {
    "limbstead": {
      "command": "/ABSOLUTE/PATH/HuggingBody/.venv/bin/hb",
      "args": ["agent", "mcp"]
    }
  }
}

What an agent can do

The in-app Assistant uses the same capabilities. It reads directly but only proposes changes, such as a complete dashboard, which you confirm in the app. Actions that need patient or staff identifiers, return credentials or publish code stay out of the Assistant.

GoalCalls
Build a dashboardlist_datasets → create_dashboard → get_dashboard → publish_dashboard
Run an analysislist_modules → create_module / create_pipeline → run_pipeline → get_run
Find metricslist_metrics, and list_modules for metrics your organization published
Find coded dashboardslist_coded_dashboards

Limits

The agent has your full in-app scope. Scoped, revocable grants for unattended agents (OAuth for MCP) are not implemented yet. This setup has not yet been verified in a live Claude Code or Codex session.

Accessibility

Make every MotionCommons page comfortable for you. Settings apply on this browser.

Text size

Your training, at your pace.

Reading & movement
Audio support

Spoken audio is unavailable in this browser. All instructions remain available as text.

Read this page speaks up to 1,800 characters of visible page text. Embedded dashboards have their own Read dashboard button.