Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Personal MCP Serverlog my workout from today and check if I hit my protein target"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Personal MCP Server
A Model Context Protocol server for personal health and well-being tracking. This server provides tools and resources for tracking workouts, nutrition, and daily journal entries, with AI-assisted analysis through Claude integration.
Features
Workout Tracking
Log exercises, sets, and reps
Track perceived effort and post-workout feelings
Calculate safe training weights with rehabilitation considerations
Historical workout analysis
Shoulder rehabilitation support
RPE-based load management
Nutrition Management
Log meals and individual food items
Track protein and calorie intake
Monitor hunger and satisfaction levels
Daily nutrition targets and progress
Pre/post workout nutrition tracking
Meal timing analysis
Journal System
Daily entries with mood and energy tracking
Sleep quality and stress level monitoring
Tag-based organization
Trend analysis and insights
Correlation analysis between workouts, nutrition, and well-being
Pattern recognition in mood and energy levels
Related MCP server: MCP Personal Assistant Agent
Installation
Installing via Smithery
To install Personal Health Tracker for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install personal-mcp --client claudePrerequisites
Python 3.10 or higher
pip or uv package manager
Using pip
pip install -e .Development Installation
git clone https://github.com/yourusername/personal-mcp.git
cd personal-mcp
uv pip install -e ".[dev]"Usage
Basic Server
Run the server with default settings:
personal-mcp runDevelopment Mode
Run with hot reloading for development:
personal-mcp devMCP Inspector
Debug with the MCP Inspector:
personal-mcp inspectClaude Desktop Integration
Install to Claude Desktop:
personal-mcp install --claude-desktopConfiguration Options
personal-mcp --helpAvailable options:
--name: Set server name (default: "Personal Assistant")--db-path: Specify database location--dev: Enable development mode--inspect: Run with MCP Inspector-v, --verbose: Enable verbose logging
MCP Tools
Workout Tools
# Log a workout
workout = {
"date": "2024-01-07",
"exercises": [
{
"name": "Bench Press",
"sets": [
{"weight": 135, "reps": 10, "rpe": 7}
]
}
],
"perceived_effort": 8
}
# Calculate training weights
params = {
"exercise": "Bench Press",
"base_weight": 200,
"days_since_surgery": 90,
"recent_pain_level": 2,
"recent_rpe": 7
}Nutrition Tools
# Log a meal
meal = {
"meal_type": "lunch",
"foods": [
{
"name": "Chicken Breast",
"amount": 200,
"unit": "g",
"protein": 46,
"calories": 330
}
],
"hunger_level": 7,
"satisfaction_level": 8
}
# Check nutrition targets
targets = await mcp.call_tool("check_nutrition_targets", {"date": "2024-01-07"})Journal Tools
# Create a journal entry
entry = {
"entry_type": "daily",
"content": "Great workout today...",
"mood": 8,
"energy": 7,
"sleep_quality": 8,
"stress_level": 3,
"tags": ["workout", "recovery"]
}
# Analyze entries
analysis = await mcp.call_tool("analyze_journal_entries", {
"start_date": "2024-01-01",
"end_date": "2024-01-07"
})Development
Running Tests
# Run all tests
pytest
# Run with coverage
pytest --cov=personal_mcp
# Run specific test file
pytest tests/test_database.pyCode Quality
# Format code
black src/personal_mcp
# Lint code
ruff check src/personal_mcp
# Type checking
mypy src/personal_mcpProject Structure
personal-mcp/
├── src/
│ └── personal_mcp/
│ ├── tools/
│ │ ├── workout.py
│ │ ├── nutrition.py
│ │ └── journal.py
│ ├── database.py
│ ├── models.py
│ ├── resources.py
│ ├── prompts.py
│ └── server.py
├── tests/
│ ├── test_database.py
│ ├── test_server.py
│ └── test_cli.py
├── pyproject.toml
└── mcp.jsonContributing
Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.