Lifeup

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

1. Install

   npm install && npm run build
   

2. Configure

   cp .env.example .env
   

   Update LIFEUP_HOST to your Android device's IP (find it in LifeUp Settings → HTTP API)

3. 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.

Links

• LifeUp Docs
• LifeUp SDK
• CLAUDE.md - Developer guide

License

MIT