# Habitify MCP

> Habitify connects your personal growth data directly from any AI agent. You manage, log, and track habits—from reps completed to daily streaks—without ever opening the mobile app. Get a full overview of your goals by asking natural questions.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** habit-tracking, personal-growth, data-logging, goal-setting, progress-analytics

## Description

Running on habit tracking requires constant manual logging and jumping between tabs. This MCP lets you talk to your agent and get instant updates about what you need to do today, or how long your streak has been. You can build new habits in chat or pull performance data for a specific month just by asking. It's like having an accountability partner who never gets tired of answering questions. Through Vinkius, you connect this power source once and get access to all the best workflow tools available. You manage everything—the logs, the stats, even organizing your focus areas—all through natural conversation.

## Tools

### add_habit_log
Records reps, minutes, or completion status against a specific habit goal.

### create_habit
Sets up tracking for an entirely new personal routine or objective.

### delete_habit
Removes a habit from your list permanently.

### get_habit
Retrieves all current details for one specific habit you're tracking.

### get_habit_stats
Calculates performance statistics for a habit over any custom date range.

### get_journal
Shows the completion status of all habits that were due on a specific day.

### list_areas
Gets a list of all categories you use to organize your different goals.

### list_habits
Displays a complete list of all habits currently active in your account.

### list_habit_logs
Retrieves every historical log entry for one specific habit.

### update_habit
Makes changes to the details or parameters of an existing habit.

## Prompt Examples

**Prompt:** 
```
What habits do I need to complete today?
```

**Response:** 
```
I've checked your journal for today. You have 4 habits pending: 'Drink 2L Water', 'Morning Meditation', 'Read 20 Pages', and 'Go for a Run'. Which one would you like to log progress for?
```

**Prompt:** 
```
Log 30 minutes of reading for today.
```

**Response:** 
```
Habit log added! I've successfully recorded 30 minutes for your 'Reading' habit. Keep up the great consistency!
```

**Prompt:** 
```
Show me my stats for 'Morning Meditation' from last week.
```

**Response:** 
```
Retrieving statistics... Last week, you completed 'Morning Meditation' 5 out of 7 days (71% consistency). Your longest streak for this habit is currently 12 days. Would you like to see the details for the missed days?
```

## Capabilities

### List all tracked habits
See a full list of every habit you currently track in your account.

### Get daily completion status
Check what goals were pending or completed on any specific date.

### Add progress logs
Record specific data, like reps or minutes, toward a habit goal.

### Generate performance reports
Pull detailed statistics and trends for any habit within a date range you specify.

### Create new goals
Set up entirely new habits or update the details of existing ones through chat commands.

## Use Cases

### Reviewing last month's performance
A user asks their agent, 'How was my meditation streak last month?' The agent calls the `get_habit_stats` tool and reports back a 71% consistency rate, identifying where they dropped off.

### Logging progress on the go
A user finishes their run. They tell their agent, 'Log 45 minutes for running.' The agent calls `add_habit_log` and records the time without needing to open the app.

### Setting up a new routine
A user realizes they need to start reading more. They prompt their agent, 'I want to track reading 20 pages daily.' The agent uses the `create_habit` tool and sets it up immediately.

### Checking today's required tasks
A user asks, 'What did I need to check off today?' The agent calls `get_journal`, listing all pending habits for the current date.

## Benefits

- Stop manual data entry. You can log progress directly via the `add_habit_log` tool without opening the app or typing anything into a form.
- Analyze long-term consistency automatically. Use `get_habit_stats` to pull performance reports for any habit over a custom time frame, letting you spot trends instantly.
- Never miss a day's goal. The agent uses `get_journal` to give you an immediate overview of what was pending completion on a specific date.
- Manage your whole system in one place. You can list all goals with `list_habits`, view organizational categories via `list_areas`, and keep everything current.
- Build or adjust habits instantly. Use the `create_habit` tool when you start a new goal, or `update_habit` if your objective changes.

## How It Works

The bottom line is you talk to your AI client and it talks to Habitify for you.

1. Subscribe to this MCP and enter your Habitify API Key in the settings.
2. Connect your agent by selecting the Habitify toolset in your client.
3. Ask a question—like, 'What did I do last week?'—and the system handles the rest.

## Frequently Asked Questions

**How do I find my Habitify API Key?**
Open the Habitify mobile app, go to **Settings > API Credentials** (or Settings > Account > API), and tap **Generate New Key**. Note that API access may require a premium subscription.

**Can I record progress for my habits via the AI agent?**
Yes! Use the `add_habit_log` tool. You can specify the habit ID and the value you want to record (e.g., '10 reps' or '30 minutes').

**Does the integration support viewing statistics?**
Yes, you can use the `get_habit_stats` tool to retrieve performance data for any habit within a specific date range, helping you analyze your consistency.

**Can I create new habits through this integration?**
Yes! The `create_habit` tool allows you to add new habits to your Habitify account directly from your conversational interface.

**How do I check my entire roster of habits using the `list_habits` tool?**
The `list_habits` tool retrieves a full list of every habit in your account. You'll get the name, category, and setup details for all your goals at once.

**What does the `get_journal` tool show about my completion status?**
The `get_journal` tool provides a comprehensive daily overview of your habits. It lists which tasks were completed and which ones are pending for that specific day.

**If I need to change an existing goal, how do I use the `update_habit` tool?**
You run the `update_habit` tool when you need to modify a habit's details. This lets you adjust things like its name or target frequency without losing your progress history.

**What are the steps if I use the `delete_habit` tool?**
The `delete_habit` tool permanently removes a habit and all associated logs. It's important to confirm you want to delete it, as this action cannot be undone.