LifeUp MCP Server

An MCP server that enables Claude to interact with LifeUp Cloud API on your local network. Supports task creation, querying, and achievement matching.

Quick Start

Install
```
npm install && npm run build
```
Configure
```
cp .env.example .env
```
Update LIFEUP_HOST to your Android device's IP (find it in LifeUp Settings → HTTP API)
Run
```
npm run start
```

Available Tools

Task Management

create_task - Create a new task with rewards
list_all_tasks - List all tasks
search_tasks - Filter tasks by criteria
get_task_history - View completed tasks
get_task_categories - List task categories

Achievements

list_achievements - List all achievements
match_task_to_achievements - Find matching achievements for a task

User Info

get_user_info - User profile and level
list_skills - Skills and progression
get_coin_balance - Current coins

Shop

list_shop_items - Browse items
get_shop_categories - Item categories
search_shop_items - Search items

Safe Mutations

edit_task - Edit existing tasks
create_achievement - Create new achievements
update_achievement - Update achievements
delete_achievement - Delete achievements
add_shop_item - Create shop items
edit_shop_item - Modify shop items
apply_penalty - Apply resource penalties
edit_skill - Manage skills

Environment Variables

LIFEUP_HOST=10.103.2.235      # Device IP
LIFEUP_PORT=13276              # API port
LIFEUP_API_TOKEN=              # Optional auth token
DEBUG=false                     # Set to 'true' for logging
SAFE_MODE=false                 # Set to 'true' to disable edit/delete mutations

Troubleshooting

Connection failed?

Ensure LifeUp is running with HTTP API enabled
Verify both devices are on the same network
Check and update LIFEUP_HOST in .env

Achievement data unavailable?

This is expected for some LifeUp versions - the server falls back to categories

Debug errors?

DEBUG=true npm run start

Safe Mode

SAFE_MODE provides protection against accidental data modification:

Enabled (SAFE_MODE=true): Allows read operations and creating new entities (tasks, achievements, shop items). Blocks editing and deleting existing data.
Disabled (SAFE_MODE=false): Full access to all 20 tools including edits and deletions.

Useful for testing or when you want Claude to help plan/create but not modify existing data.

License

MIT

LifeUp