English Français العربية

io.github.contactxyz-admin/morningform

Official registry Developer tools

stdio MCP proxy for MorningForm — bridges Claude Code to MorningForm HTTPS MCP server.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @morningform/mcp
Claude Code 
claude mcp add morningform -e 'MORNINGFORM_TOKEN=<your morningform_token>' -e 'MORNINGFORM_URL=<MORNINGFORM_URL>' -- npx -y @morningform/mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "morningform": {
            "command": "npx",
            "args": [
                "-y",
                "@morningform/mcp@0.1.0"
            ],
            "env": {
                "MORNINGFORM_TOKEN": "<your morningform_token>",
                "MORNINGFORM_URL": "<MORNINGFORM_URL>"
            }
        }
    }
}

Environment variables

  • MORNINGFORM_TOKEN required secret Bearer token issued from https://morning-form.vercel.app/settings/integrations/claude
  • MORNINGFORM_URL Server endpoint override. Defaults to the production MorningForm host. Only override for local dev — controls where your bearer token is sent.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Morning Form
  2. Local development
  3. Current branch workflow
  4. Health integrations
  5. Metrics
  6. Retest loop
  7. Retrieval

Morning Form

Morning Form is a premium mobile-first state-optimization web app covering assessment, profile generation, protocol recommendation, daily guidance, check-ins, insights, and wearable integrations.

Local development

cd /Users/reubenselby/Desktop/morning-form
npm install
npx prisma db push
npm run db:seed
npm run dev

App URL:

http://localhost:3000

Demo user seeded locally:

demo@morningform.com

Current branch workflow

  • main: built MVP
  • feat/real-health-oauth: review branch for real provider connection wiring

Open PR:

https://github.com/contactxyz-admin/morning-form/pull/1

Health integrations

Morning Form currently supports:

  • Terra-backed Apple Health and Garmin connection flow
  • Direct OAuth scaffolding for Whoop, Oura, Fitbit, and Google Fit
  • persisted provider connections via Prisma
  • callback routes and token exchange when credentials are configured
  • graceful mock fallback when credentials are absent

Detailed provider setup lives in:

docs/HEALTH_PROVIDER_SETUP.md

Metrics

Retest loop

The retest loop (off by default, behind RETEST_LOOP_ENABLED) runs the "return leg": a lab panel completes a Draw, the next retest is scheduled, a daily Vercel cron (/api/cron/retest-nudge, gated by CRON_SECRET) sends a capped nudge sequence, and retention-to-retest is measured (nudge-attributed = loop-caused). The metrics CLI above appends a retest-retention section when the flag is on. Backfill existing users (run dark, before the flip): npx tsx scripts/retest/backfill-baseline-draws.ts (dry run) then --apply. Tunables live in src/lib/retest/constants.ts. See docs/runbooks/retest-loop-go-live.md and docs/plans/2026-06-17-001-feat-return-leg-retest-loop-plan.md.

Retrieval

Hybrid retrieval is enabled when an embedding provider is configured. It embeds only SourceChunk.text, stores one VectorEmbedding per chunk, and keeps search_graph_nodes on the same public contract while ranking with vector + lexical + graph RRF. Set HYBRID_RETRIEVAL_ENABLED=false to roll back to legacy lexical/graph behavior.

Production rollout:

npx prisma generate
npx prisma db push
npx tsx scripts/backfill-embeddings.ts --dry-run --estimate
npx tsx scripts/backfill-embeddings.ts --batch 80

See docs/runbooks/hybrid-retrieval-production.md and docs/runbooks/backfill-embeddings.md.

Frequently asked questions

What is io.github.contactxyz-admin/morningform?

stdio MCP proxy for MorningForm — bridges Claude Code to MorningForm HTTPS MCP server.

How do I install io.github.contactxyz-admin/morningform?

It runs on your machine. In Claude Code: claude mcp add morningform -e 'MORNINGFORM_TOKEN=<your morningform_token>' -e 'MORNINGFORM_URL=<MORNINGFORM_URL>' -- npx -y @morningform/mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.contactxyz-admin/morningform need an API key?

Yes. It expects MORNINGFORM_TOKEN, which you set in its configuration.

Is io.github.contactxyz-admin/morningform open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.contactxyz-admin/morningform?

It is published by contactxyz-admin. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.