habitify

Habitify MCP Server provides a bridge between Habitify API data and AI assistants. It exposes a set of 12 tools that let you retrieve and manipulate habit data, such as journals, habits, moods, notes, and actions, directly from AI workflows in Cursor, Claude, VS Code, or other MCP clients. The server uses your Habitify API key to authenticate requests and surface Habitify data through a stable MCP interface, enabling automated workflows and real-time access to Habitify resources through natural-language or structured tool calls.

You can launch the MCP server using npx with the published package @sargonpiraev/habitify-mcp-server. Once running, configure your MCP client (Cursor, VS Code, Claude Desktop, etc.) to point at the habitify-mcp-server entry and provide your API key. The available tools (get-journal, add-habit-log, delete-habit-logs-range, delete-habit-log, get-habits, get-habit, get-areas, get-moods, add-mood, get-notes, add-note, get-actions) can be invoked from your AI prompts or integrated into automated prompts, enabling seamless habit data retrieval and updates within AI-driven workflows.

Prerequisites:\n- Node.js >= v18.0.0 (or ensure your environment supports npx)\n- Habitify API key\n\nInstallation options:\n1) Install via Smithery (automatic):\nbash\nnpx -y @smithery/cli@latest install @sargonpiraev/habitify-mcp-server --client <CLIENT_NAME>\n\n2) Install in Cursor (one-click or manual):\n- One-click install: use the provided Cursor MCP install link in the README.\n- Manual configuration: add to your Cursor config (e.g., ~/.cursor/mcp.json) with:\njson\n{\n "mcpServers": {\n "habitify-mcp-server": {\n "command": "npx",\n "args": ["-y", "@sargonpiraev/habitify-mcp-server"],\n "env": {\n "HABITIFY_API_KEY": "your-habitify_api_key"\n }\n }\n }\n}\n\n3) Install in VS Code: add to VS Code settings or use the provided install link.\n- Settings snippet:\njson\n"mcp": {\n "servers": {\n "habitify-mcp-server": {\n "type": "stdio",\n "command": "npx",\n "args": ["-y", "@sargonpiraev/habitify-mcp-server"],\n "env": {\n "HABITIFY_API_KEY": "your-habitify_api_key"\n }\n }\n }\n}\n\n4) Install in Claude Desktop: add to claude_desktop_config.json:\njson\n{\n "mcpServers": {\n "habitify-mcp-server": {\n "command": "npx",\n "args": ["-y", "@sargonpiraev/habitify-mcp-server"],\n "env": {\n "HABITIFY_API_KEY": "your-habitify_api_key"\n }\n }\n }\n}\n

Environment considerations:\n- Always provide HABITIFY_API_KEY with the required permissions for the actions you intend to perform.\n- If you encounter authentication errors, double-check API key scope and ensure it is active.\n- The MCP server exposes 12 tools; consult the Tools section in the README to understand required parameters for each tool.\n- When running locally, ensure network access to Habitify API and proper firewall allowances for your MCP client.\n- If you are updating the server version, re-run the installation command to ensure the latest package is in use.\n- For debugging, enable verbose logging if supported by your MCP client or check console outputs from the running Node process.