Skip to main content
Glama

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

  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

Related MCP server: Super Productivity MCP Server

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

Available Tools

26 tools
add_shop_itemB

Create a new shop item with price, stock, effects, and purchase limits. Items can have custom usage effects like coin rewards, exp bonuses, or special actions.

Inputs: name (required), desc, icon, title_color_string, +8 more.

apply_penaltyA

Apply a penalty to the player (coins, experience points, or items) with a custom reason. The reason will be displayed in history pages. Use this to subtract resources directly.

Inputs: type (required), content (required), number (required), skills, +3 more.

create_achievementA

Create a new custom achievement with unlock conditions and rewards. Requires achievement name and category ID. Optionally specify unlock conditions (JSON array), experience/coin rewards, skill rewards, item rewards, and appearance settings. Created achievements are locked by default.

Inputs: name (required), category_id (required), desc, conditions_json, +10 more.

create_subtaskA

Create a new subtask for an existing task in LifeUp. Subtasks are smaller action items that belong to a parent task. You must specify the parent task using at least one identifier (main_id, main_gid, or main_name). Subtasks can have their own rewards, reminders, and item rewards.

Inputs: todo (required), main_id, main_gid, main_name, +9 more.

create_taskA

Create a new task in LifeUp. Specify task name and optional rewards (experience points and coins). When setting XP, you must provide skillIds to indicate which attributes receive the XP. The task will be created as an active task in your LifeUp app. This tool will prompt you to confirm the server is running if it cannot connect.

Inputs: name (required), exp, skillIds, coin, +10 more.

delete_achievementA

Delete an achievement by ID. This action is permanent and cannot be undone. Use with caution.

Inputs: edit_id (required).

delete_taskA

⚠️ Permanently delete a task from your LifeUp app. This action cannot be undone. Requires explicit task ID to prevent accidental deletions. This tool is blocked in SAFE_MODE.

Inputs: taskId (required).

edit_shop_itemA

Modify an existing shop item. Can adjust price, stock, owned quantity, effects, and other properties. Supports both absolute setting and relative adjustments for numeric values.

Inputs: id, name, set_name, set_desc, +9 more.

edit_skillA

Create a new skill or edit an existing skill (name, icon, color, experience). Can also delete skills. Skills represent character attributes that can be leveled up.

Inputs: id, content, desc, icon, +3 more.

edit_subtaskB

Edit an existing subtask in LifeUp. You must specify both the parent task (using main_id, main_gid, or main_name) and the subtask to edit (using edit_id, edit_gid, or edit_name). Supports both absolute and relative value adjustments for coin and experience rewards.

Inputs: main_id, main_gid, main_name, edit_id, +14 more.

edit_taskA

Edit an existing task in LifeUp. You can modify task name, rewards, category, and other properties. When using exp_set_type="rel" or coin_set_type="rel", the exp and coin values are added to existing values. When using "abs" (absolute), values replace existing ones. This tool is blocked in SAFE_MODE.

Inputs: id (required), name, content, exp, +12 more.

get_coin_balanceA

Get your current coin balance and currency information. Coins are the in-game currency used to purchase items from the shop. Useful for planning purchases and understanding your economy.

Inputs: no named parameters.

get_shop_categoriesA

List all shop item categories. Categories help organize items in the shop and make browsing easier.

Inputs: no named parameters.

get_task_categoriesB

List all task categories/lists available in your LifeUp app.

Inputs: no named parameters.

get_task_detailsA

Get detailed information about a specific task, including rewards, subtasks, timestamps, and completion history. Requires task ID.

Inputs: taskId (required), includeHistory, historyLimit.

get_task_historyB

Retrieve your task completion history. Shows recently completed tasks with timestamps and rewards earned. Helpful for understanding your productivity patterns and accomplishments.

Inputs: taskId, offset, limit.

get_user_infoA

Get user profile information including player name, character level, total experience, and app version. Useful for understanding the current state of your LifeUp account.

Inputs: no named parameters.

list_achievement_categoriesA

List all achievement categories. Categories help organize achievements and are needed when creating new achievements. Shows category names, IDs, and descriptions.

Inputs: no named parameters.

list_achievementsA

List all available achievements in your LifeUp app. Shows both unlocked and locked achievements with their descriptions and progress. If full achievement data is unavailable in your LifeUp version, shows achievement categories instead.

Inputs: no named parameters.

list_all_tasksA

List all tasks from your LifeUp app. Returns active and completed tasks, showing task names, descriptions, and rewards. Useful for reviewing your current workload or understanding task patterns.

Inputs: no named parameters.

list_shop_itemsA

List all items available in the shop with prices, stock availability, and your owned quantity. Shows both in-stock and out-of-stock items. Useful for browsing available rewards and planning future purchases.

Inputs: no named parameters.

list_skillsA

List all character skills with their current levels, experience points, and progress toward the next level. Useful for understanding your character progression and which skills to focus on.

Inputs: no named parameters.

match_task_to_achievementsA

Match a task to potentially relevant achievements based on task name and keywords. Helps identify which achievements could be earned by completing specific tasks. Uses keyword matching and category cross-reference. Returns top 5 matches with confidence scores.

Inputs: taskName (required), categoryId.

search_shop_itemsA

Search and filter shop items by criteria such as name, category, or price range. Useful for finding specific items or comparing prices across different categories.

Inputs: searchQuery, categoryId, minPrice, maxPrice.

search_tasksA

Search and filter tasks by criteria such as name, status (active/completed), category, or deadline. Useful for finding specific tasks or analyzing tasks by various dimensions.

Inputs: searchQuery, categoryId, status, deadlineBefore.

update_achievementA

Update an existing achievement by ID. Modify name, description, rewards, and unlock status. ⚠️ IMPORTANT: Updating conditions_json is NOT supported by the LifeUp API. If you need to change conditions, delete this achievement and create a new one with desired conditions. Set numeric rewards using absolute (replace) or relative (add to current) set types. Always verify changes in the LifeUp app after updating.

Inputs: edit_id (required), name, category_id, desc, +10 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 26 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action (tasks, achievements, shop items, skills, user info, penalties). Even where edit_skill handles creation/deletion, it's clearly described. No overlapping purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., create_task, list_achievements, get_coin_balance). No mixing of conventions or unclear naming.

    Tool Count5/5

    26 tools are well-scoped for a full-featured gamification server, covering all major domains (tasks, achievements, shop, skills, user info) without redundancy. Each tool justifies its presence.

    Completeness5/5

    The tool set covers CRUD operations for tasks, subtasks, achievements, and shop items, plus reading user info and coin balance. No obvious gaps in lifecycle coverage for the stated domains.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers