Add it to Claude Code
claude mcp add -e "JHABIT_URL=${JHABIT_URL}" -e "JHABIT_API_KEY=${JHABIT_API_KEY}" jhabit -- npx -y jhabit-mcpJHABIT_URLJHABIT_API_KEYMake your agent remember this setup
jhabit's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Manage habit and quit trackers directly from Claude
- Retrieve detailed statistics like streaks and abstinence time
- Log daily progress or slips for specific trackers
- Create new trackers with custom names and emojis
- Support for local stdio-based MCP clients
Tools 5
list_trackersList all habits and/or quits.create_trackerCreate a new habit or quit tracker.log_entryLog an entry for a habit or quit tracker.delete_entryDelete an entry by ID.get_tracker_statsGet stats for a tracker including streaks or abstinence time.Environment Variables
JHABIT_URLrequiredBase URL of your jhabit instanceJHABIT_API_KEYrequiredAPI key for authenticationTry it
Original README from Jacob-Stokes/jhabit-mcp
Standalone MCP server for jhabit — a habit and quit tracker. Connects to your jhabit instance via API key and exposes tracking tools to MCP clients like Claude Desktop and Claude Code.
Note: jhabit also has a built-in remote MCP server using OAuth 2.1 + Streamable HTTP, for cloud-based MCP clients. This standalone server is for local stdio-based clients.
Setup
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"jhabit": {
"command": "npx",
"args": ["-y", "jhabit-mcp"],
"env": {
"JHABIT_URL": "https://your-jhabit-instance.com",
"JHABIT_API_KEY": "your-api-key-here"
}
}
}
}
Claude Code
{
"mcpServers": {
"jhabit": {
"command": "npx",
"args": ["-y", "jhabit-mcp"],
"env": {
"JHABIT_URL": "https://your-jhabit-instance.com",
"JHABIT_API_KEY": "your-api-key-here"
}
}
}
}
From source
git clone https://github.com/Jacob-Stokes/jhabit-mcp.git
cd jhabit-mcp
npm install && npm run build
JHABIT_URL=https://your-instance.com JHABIT_API_KEY=your-key node dist/index.js
Getting an API Key
- Log into your jhabit instance
- Go to Settings > API Keys
- Create a new key and copy it
Environment Variables
| Variable | Required | Description |
|---|---|---|
JHABIT_URL |
Yes | Base URL of your jhabit instance |
JHABIT_API_KEY |
Yes | API key for authentication |
Available Tools
`list_trackers`
List all habits and/or quits.
type(optional): Filter by"habit"or"quit"
`create_tracker`
Create a new habit or quit tracker.
name(required): Tracker name, e.g. "Meditate" or "Smoking"type(required):"habit"or"quit"emoji(optional): Emoji icon
`log_entry`
Log an entry. For habits = "I did it". For quits = "I slipped up".
tracker_id(required): Tracker IDtimestamp(optional): ISO timestamp, defaults to nownote(optional): Note
`delete_entry`
Delete an entry by ID.
entry_id(required): Entry ID
`get_tracker_stats`
Get stats for a tracker.
tracker_id(required): Tracker ID
Returns streaks (current/best) for habits, or abstinence time and slip count for quits.