Personal

Private MCP server for workouts, nutrition, and journaling with AI-assisted insights.

python

9

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "evangstav-personal-mcp": {
      "command": "personal-mcp",
      "args": [
        "run"
      ]
    }
  }
}

The Personal MCP Server lets you track workouts, nutrition, and daily journal entries in a private, AI-assisted environment. It provides structured tools to log activities, monitor recovery, manage daily goals, and derive insights that help you improve your health and well-being.

How to use

You interact with the Personal MCP Server through an MCP client. Start by running the server locally, then connect your client to manage workouts, nutrition, and journal entries. Use the client to log workouts with sets, reps, and perceived effort; enter meals with portion sizes and nutrition details; and create daily journal entries that capture mood, energy, sleep, and stress. The server analyzes your data over time and can show correlations between your workouts, nutrition, and well-being.

How to install

# Prerequisites
# Ensure Python 3.10+ is installed
# Ensure a Python-friendly environment is available (pip or uvx)

# Basic installation (development-friendly for Python projects)
pip install -e .

# Optional: development setup (if you plan to contribute)
git clone https://github.com/yourusername/personal-mcp.git
cd personal-mcp
uv pip install -e ".[dev]"

# Run the server with default settings
personal-mcp run

# Development mode with hot reload
personal-mcp dev

# Debug with MCP Inspector
personal-mcp inspect

# Optional Claude Desktop integration setup
personal-mcp install --claude-desktop

# Help and configuration options
personal-mcp --help

Configuration and usage notes

You can customize how the server runs and where it stores data using a few command-line options. You can set a custom server name, specify a database path, enable development mode, enable the MCP Inspector, and adjust logging verbosity.

# Example: run with a custom name and database path
personal-mcp run --name "My Personal MCP" --db-path "/path/to/db" 

# Enable verbose logging
personal-mcp run -v

Available tools

log_workout

Log a workout with exercises, sets, reps, and RPE; track perceived effort and post-workout feelings and analyze historical data for progress and rehab considerations.

log_nutrition

Log meals and individual foods with portions, protein, calories, hunger, and satisfaction levels; monitor daily targets and timing.

journal_analysis

Create daily journal entries with mood, energy, sleep, stress, and tags; analyze trends and correlations across workouts, nutrition, and well-being.