lifeup-mcp
Allows interaction with the LifeUp app on Android devices, enabling task management, achievement operations, user info retrieval, and shop management through the LifeUp Cloud API over the local network.
Click on "Deploy 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., "@lifeup-mcp create a task to exercise for 30 minutes with 100 coin reward"
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.
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 buildConfigure
cp .env.example .envUpdate
LIFEUP_HOSTto your Android device's IP (find it in LifeUp Settings → HTTP API)Run
npm run start
Related MCP server: Super Productivity MCP Server
Available Tools
Task Management
create_task- Create a new task with rewardslist_all_tasks- List all taskssearch_tasks- Filter tasks by criteriaget_task_history- View completed tasksget_task_categories- List task categories
Achievements
list_achievements- List all achievementsmatch_task_to_achievements- Find matching achievements for a task
User Info
get_user_info- User profile and levellist_skills- Skills and progressionget_coin_balance- Current coins
Shop
list_shop_items- Browse itemsget_shop_categories- Item categoriessearch_shop_items- Search items
Safe Mutations
edit_task- Edit existing taskscreate_achievement- Create new achievementsupdate_achievement- Update achievementsdelete_achievement- Delete achievementsadd_shop_item- Create shop itemsedit_shop_item- Modify shop itemsapply_penalty- Apply resource penaltiesedit_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 mutationsTroubleshooting
Connection failed?
Ensure LifeUp is running with HTTP API enabled
Verify both devices are on the same network
Check and update
LIFEUP_HOSTin.env
Achievement data unavailable?
This is expected for some LifeUp versions - the server falls back to categories
Debug errors?
DEBUG=true npm run startSafe 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
CLAUDE.md - Developer guide
License
MIT
Available Tools
26 toolsadd_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
Scored across 26 tools
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.
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.
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.
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
Related MCP Connectors
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Habitica MCP server for ChatGPT, Claude and any AI agent: list tasks, create task, score habit or daily, update checklist, hatch and feed pets and start party quest in your own Habitica account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Habitica yourself; Cotlet does not store your password and you need no Habitica API key. About the official Habitica API: Habitica has a full public REST API (v3) but no official MCP server (checked 17 Oct 2026). The API reads and changes tasks, tags, pets, mounts, parties and quests. Setup and FAQ: https://cotlet.dev/integrations/habitica-api-mcp-server
Related MCP Servers
- AlicenseBqualityDmaintenanceIntegrates Claude with Todoist for natural language task management, supporting project and section organization, task creation, updating, completion, and deletion using everyday language.1916 npm22MIT
- AlicenseAqualityDmaintenanceEnables Claude to interact with Super Productivity's local REST API for task, project, and tag management, including CRUD operations, status checks, and daily planning prompts.17264 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to manage Todoist tasks and projects, including creating, listing, updating, completing tasks, and managing projects with natural language.51 npmMIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude to your TickTick account with 28 tools for full CRUD task management, smart queries, batch operations, and GTD support, letting you manage tasks through natural conversation.1MIT