Habitify MCP Server 🔧

MCP server for seamless Habitify API integration with AI assistants. Track habits, manage mood logs, create notes, and automate habit tracking workflows directly from Claude, Cursor, and other MCP-compatible AI tools.

Features

• 🔌 Seamless AI Integration: Direct Habitify API access from Claude, Cursor, and VS Code
• 🤖 Automated Workflows: Automate habit tracking, mood logging, and note creation
• 📊 Complete API Coverage: 23+ tools covering habits, moods, logs, notes, and actions
• 🎯 Selective Tool Loading: Enable specific tools with glob patterns
• ⚡ Real-time Tracking: Log habits, moods, and create notes instantly from AI assistants
• 🔧 Professional Integration: Error handling, validation, and comprehensive logging

Add use habitify to your prompt in Cursor or Claude.

Get Your Credentials

Before installation, you'll need a Habitify API key:

1. Open Habitify app or web interface
2. Go to Settings → Account → API Access
3. Generate new API key or copy existing one
4. Save this key for the installation steps below

Requirements

• Node.js >= v18.0.0
• Habitify API key (get from Habitify Settings)
• Cursor, VS Code, Claude Desktop or another MCP Client

Installation

<details> <summary><b>Installing via Smithery</b></summary>

To install Habitify MCP Server for any client automatically via Smithery:

npx -y @smithery/cli@latest install @sargonpiraev/habitify-mcp-server --client <CLIENT_NAME>

</details>

<details> <summary><b>Install in Cursor</b></summary>

Cursor One-Click Installation

Manual Configuration

Add to your Cursor ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "habitify-mcp-server": {
      "command": "npx",
      "args": ["-y", "@sargonpiraev/habitify-mcp-server"],
      "env": {
        "HABITIFY_API_KEY": "your-habitify-api-key"
      }
    }
  }
}

</details>

<details> <summary><b>Install in VS Code</b></summary>

Or add manually to your VS Code settings:

"mcp": {
  "servers": {
    "habitify-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sargonpiraev/habitify-mcp-server"],
      "env": {
        "HABITIFY_API_KEY": "your-habitify-api-key"
      }
    }
  }
}

</details>

<details> <summary><b>Install in Claude Desktop</b></summary>

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "habitify-mcp-server": {
      "command": "npx",
      "args": ["-y", "@sargonpiraev/habitify-mcp-server"],
      "env": {
        "HABITIFY_API_KEY": "your-habitify-api-key"
      }
    }
  }
}

</details>

Available Tools

Tool Selection

Enable specific tools using glob patterns:

# Enable only 'get' tools
TOOL_GLOB_PATTERNS="get-*" npx @sargonpiraev/habitify-mcp-server

# Enable all except delete operations
TOOL_GLOB_PATTERNS="*,!delete-*" npx @sargonpiraev/habitify-mcp-server

# Enable specific tools
TOOL_GLOB_PATTERNS="get-journal,add-log,create-mood" npx @sargonpiraev/habitify-mcp-server

Tools List

• get-journal: Get list of habits for a specific date with filtering options
• add-log: Add quantifiable habit log (numbers, measurements)
• get-logs: Retrieve habit logs with filtering
• delete-log: Delete a specific habit log entry
• delete-logs: Delete multiple habit log entries
• create-mood: Create new mood entry (1-5 scale)
• get-mood: Get specific mood entry by ID
• get-moods: Get multiple mood entries with filtering
• update-mood: Update existing mood entry
• delete-mood: Delete mood entry
• create-action: Create habit-related action items and reminders
• get-action: Get specific action by ID
• get-actions: Get multiple actions with filtering
• update-action: Update existing action
• delete-action: Delete action item
• add-text-note: Add text notes to habits
• get-notes: Retrieve notes with filtering
• delete-note: Delete specific note
• delete-notes: Delete multiple notes
• get-habit-status: Get habit completion status
• update-habit-status: Update habit status (completed, skipped, none)
• get-areas: Get all habit categories/areas

Total: 23 tools available 🎯

Support This Project

Hi! I'm Sargon, a software engineer passionate about AI tools and automation. I create open-source MCP servers to help developers integrate AI assistants with their favorite services.

Your support helps me continue developing and maintaining these tools, and motivates me to create new integrations that make AI assistants even more powerful! 🚀

Connect with Author

• 🌐 Visit sargonpiraev.com
• 📧 Email: sargonpiraev@gmail.com
• 💬 Join Discord