Model Context Protocol

Bring your habits to your AI assistant.

Habityzer exposes a secure MCP server, so Claude and any MCP-compatible assistant can read your real habits, streaks and goals — and give you grounded, personal coaching instead of guesswork. You stay in control with a token you can revoke anytime.

Connect in 3 steps Browse the API

MCP endpoint https://www.habityzer.com/mcp

Transport: Streamable HTTP (JSON-RPC 2.0) · Auth: Bearer app token

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants securely connect to external tools and data. Point a compatible assistant at Habityzer and it can pull your progress on demand — no copy-pasting, no screenshots.

You hold the key

Access is granted by an app token you create and can revoke at any moment. No token, no access.

Read-only by design

The MCP tools surface insights and statistics. Your assistant can look — it cannot change or delete your data.

Works with any client

Claude Desktop, IDE assistants, custom agents — anything that speaks MCP over HTTP can connect.

5 tools available

What your assistant can see

Each tool maps to your own data, scoped to your account. Ask in plain language — your assistant picks the right tool.

Goals overview

All of your goals and their current objectives — perfect for “how am I doing on my goals?”

api_goals_get_collection

Goal statistics

Progress stats for your goals, optionally filtered by date range or a specific goal.

api_goal_stats_get_collection

Habit streaks

Current streak counts for every active habit — the “don’t break the chain” numbers.

api_habitsstreaks_get_collection

Day-of-week patterns

When you actually complete habits across the week, so your assistant can spot weak spots.

api_habit_entriespatterns_get

Weekly habit stats

Weekly completion statistics across your habits, with optional date filtering.

api_habit_stats_get_collection

Setup

Connect in three steps

From zero to “ask Claude about my streaks” in a couple of minutes.

Generate an app token

A token is a secret string starting with app_. The quickest way is from the app: open your account and create a token under Settings → API tokens.

Open token settings

Copy it right away. For your security the full token is shown only once, when it’s created.

Add Habityzer to your MCP client

Point your client at the endpoint below and send your token in the Authorization header. Most modern clients support remote HTTP MCP servers directly:

{
  "mcpServers": {
    "habityzer": {
      "type": "http",
      "url": "https://www.habityzer.com/mcp",
      "headers": {
        "Authorization": "Bearer app_your_token_here"
      }
    }
  }
}

If your client only supports local (stdio) servers, bridge to the HTTP endpoint with mcp-remote:

{
  "mcpServers": {
    "habityzer": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.habityzer.com/mcp",
        "--header",
        "Authorization: Bearer app_your_token_here"
      ]
    }
  }
}

Just ask

Restart your client and start a conversation. Try prompts like:

› “What are my current habit streaks?”
› “Which day of the week do I skip habits most?”
› “How close am I to my goals this month?”

Want to test the connection from a terminal first?

curl -X POST https://www.habityzer.com/mcp \
  -H "Authorization: Bearer app_your_token_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Generating an app token

A token authenticates the connection as you. Pick whichever method fits how you work.

Recommended

From the app

Sign in, then go to Settings → API tokens and click Create token. Give it a name like “Claude MCP”, and copy the value once it appears.

API

Programmatically

Already authenticated? Create one via the REST API:

POST https://www.habityzer.com/api/app_tokens

{
  "name": "Claude MCP",
  "tokenType": "default"
}

The response includes the token field — shown only on creation.

Self-hosted

From the CLI

Running your own instance? Use the console command:

php bin/console \
  app:token:manage create \
  [email protected] \
  --name="Claude MCP"

Also supports list, revoke and cleanup.

Format

app_ + 64 hex characters

Default lifetime

30 days (long-lived: 1 year)

Revoke anytime

Instantly disables the token

Your data stays yours

Every MCP request is authenticated and scoped to the token owner — an assistant only ever sees your habits and goals. The tools are read-only insight endpoints, so nothing can be edited or deleted over MCP. Treat your token like a password: never share it or commit it to a repo, and revoke it the moment a device or client is no longer trusted.

Let your assistant in on your progress

Create a token, connect your favorite MCP client, and turn your Habityzer data into personal, data-grounded coaching.

Get your token Explore the API