UpTier

UpTier exposes an MCP server that lets Claude Desktop access and manage your tasks through standardized, programmable tools. It enables intelligent prioritization, smart task handling, and seamless data exchange between the desktop app and Claude, so you can focus on what matters most while keeping your work organized.

How to use

You interact with the UpTier MCP server by connecting Claude Desktop to the local MCP server and using its built-in tools to create, organize, prioritize, and track tasks. Start by ensuring the MCP server is deployed and running, then configure Claude Desktop to reach that local server. From there you can command Claude to create lists, add tasks, assign priorities, and query progress across goals and subtasks.

How to install

Prerequisites: You need Node.js 20+ (LTS recommended) and pnpm 8+. You should also have Claude Desktop installed to use AI-powered features.

Step-by-step to get the MCP server running and available to Claude Desktop:

# Clone the repository
git clone https://github.com/foxintheloop/uptier.git
cd uptier

# Install pnpm (if not already installed)
npm install -g pnpm

# Install dependencies
pnpm install

# Approve build scripts for native modules (canvas, sharp, electron)
pnpm approve-builds

# Rebuild native modules
pnpm rebuild

# Build packages
pnpm --filter @uptier/shared build
pnpm --filter @uptier/mcp-server build

Starting and configuring the MCP server for Claude Desktop

To run in development mode, you typically start the Electron app and the MCP server separately during development. For Claude Desktop integration you may deploy a standalone MCP server that Claude Desktop can connect to.

Recommended deployment for Claude Desktop integration: deploy the MCP server to a standalone directory so native modules are compiled for your current Node.js version and there are no conflicts with the Electron app.

pnpm --filter @uptier/mcp-server deploy

This places the MCP server under ~/.uptier/mcp-server/ with its own node_modules and updates the Claude Desktop config automatically. If you encounter issues, restart Claude Desktop after deployment so the new tools become available.

## Manual configuration for Claude Desktop

If automatic deployment isn’t working, you can add UpTier to Claude Desktop manually using a local configuration pointing to the MCP server script.

{ "mcpServers": { "uptier": { "command": "node", "args": ["/path/to/.uptier/mcp-server/index.js"] } } }

## Available tools

### create\_list

Create a new task list.

### get\_lists

Retrieve all lists with task counts.

### update\_list

Update list properties such as name, color, or icon.

### delete\_list

Delete a specific list.

### reorder\_lists

Change the order of lists.

### create\_task

Create a new task with optional attributes.

### get\_tasks

Fetch tasks with filtering options.

### update\_task

Update properties of a task.

### complete\_task

Mark a task as completed.

### delete\_task

Delete a task.

### bulk\_create\_tasks

Create multiple tasks in one operation.

### move\_task

Move a task to a different list.

### prioritize\_list

Analyze tasks and receive prioritization guidance.

### bulk\_set\_priorities

Set priority tiers for multiple tasks at once.

### get\_prioritization\_summary

Get an overview of task priorities.

### suggest\_next\_task

Receive AI recommendations for the next task to work on.

### create\_goal

Create a goal to track progress.

### get\_goals

Retrieve all goals with progress data.

### update\_goal

Update properties of a goal.

### link\_tasks\_to\_goal

Associate tasks with a goal.

### get\_goal\_progress

Get completion stats for a goal.

### add\_subtask

Add a subtask to a task.

### update\_subtask

Update subtask properties.

### create\_tag

Create a new tag.

### get\_tags

Retrieve all tags.

### add\_tag\_to\_task

Tag a task with a tag.