UpTier is a desktop to-do application that combines a clean Microsoft To Do-style interface with the power of Claude AI for intelligent task prioritization. Through the Model Context Protocol (MCP), Claude can analyze your tasks and help you focus on what matters most. Download UpTier for Windows Pre-built installer available. No build required. - Lists & Tasks - Create custom lists, tasks with su
Add this skill
npx mdskills install foxintheloop/uptierComprehensive MCP server for task management with 25+ well-documented tools and intelligent prioritization
1# UpTier23> MCP-powered task management with intelligent prioritization via Claude Desktop45[](LICENSE)6[]()7[](https://registry.modelcontextprotocol.io/?q=uptier)89UpTier is a desktop to-do application that combines a clean Microsoft To Do-style interface with the power of Claude AI for intelligent task prioritization. Through the Model Context Protocol (MCP), Claude can analyze your tasks and help you focus on what matters most.1011## Demo1213https://github.com/user-attachments/assets/71264f79-3f54-4b45-9d7e-dcef26f54f941415## Download1617**[Download UpTier for Windows](https://github.com/foxintheloop/uptier/releases/latest)**1819Pre-built installer available. No build required.2021## Features2223### Task Management24- **Lists & Tasks** - Create custom lists, tasks with subtasks, and organize your work25- **Smart Lists** - Built-in views for My Day, Important, Planned, and Completed tasks26- **Custom Filters** - Create your own smart lists with visual filter rules (due date, priority, tags, energy, and more)27- **Tags** - Categorize tasks with colored tags for easy filtering28- **Due Dates** - Set due dates with notifications and overdue tracking29- **Recurring Tasks** - Daily, weekday, weekly, biweekly, and monthly recurrence with optional end dates30- **Day Planner** - Time-blocking calendar view with hourly grid, drag-and-drop scheduling, and block resizing31- **Task Duration** - Set estimated duration for tasks to size time blocks on the calendar32- **Drag & Drop** - Reorder tasks within lists and schedule tasks onto the calendar3334### AI-Powered Features35- **Intelligent Prioritization** - Let Claude analyze and prioritize your tasks36- **Multiple Strategies** - Eisenhower matrix, quick wins, high impact, and more37- **Auto-Suggestions** - Get AI recommendations for task organization3839### Organization40- **Goal Tracking** - Link tasks to goals and track progress41- **Priority Tiers** - Three-tier system (Do Now, Do Soon, Backlog)42- **Priority Scoring** - Rate tasks by effort, impact, urgency, and importance43- **Data Export** - Export your data for backup or analysis4445### Multi-Database Support46- **Multiple Profiles** - Create separate databases for work, personal, projects47- **Easy Switching** - Switch between database profiles from the sidebar48- **Isolated Data** - Each profile maintains its own lists, tasks, and settings4950### Focus Timer51- **Distraction-Free Mode** - Full-screen timer overlay to help you stay focused52- **Flexible Durations** - Preset options (30, 45, 60, 90 min) or custom duration53- **Task Context** - See task title and notes while working54- **Keyboard Controls** - Space to pause/resume, Esc to end session5556### User Experience57- **Themes** - Dark, Light, Earth Dark, Earth Light, and Cyberpunk themes58- **Command Palette** - Global search and navigation with Ctrl+K59- **Keyboard Shortcuts** - Quick actions with Ctrl+F (search), Ctrl+N (new task)60- **System Tray** - Minimize to tray for quick access61- **Concurrent Access** - SQLite with WAL mode lets both the app and Claude work simultaneously6263## Architecture6465```66uptier/67├── apps/68│ ├── electron/ # Desktop application (React + Electron)69│ └── mcp-server/ # MCP server for Claude Desktop70├── packages/71│ └── shared/ # Shared types and database schema72└── pnpm-workspace.yaml73```7475| Component | Description |76|-----------|-------------|77| **MCP Server** | Node.js server providing 25+ task management tools via MCP |78| **Electron App** | Desktop application with React UI |79| **SQLite Database** | Shared database with WAL mode for concurrent access |8081## Getting Started8283### Prerequisites8485- [Node.js](https://nodejs.org/) 20+ (LTS recommended)86- pnpm 8+87- Claude Desktop (for AI features)8889### Installation9091```bash92# Clone the repository93git clone https://github.com/foxintheloop/uptier.git94cd uptier9596# Install pnpm (if not already installed)97npm install -g pnpm9899# Install dependencies100pnpm install101102# Approve build scripts for native modules (canvas, sharp, electron)103pnpm approve-builds104105# Rebuild native modules106pnpm rebuild107108# Rebuild better-sqlite3 for Electron's bundled Node.js109npx electron-rebuild -f -w better-sqlite3110111# Build packages112pnpm --filter @uptier/shared build113pnpm --filter @uptier/mcp-server build114```115116> **Note:** The Electron app bundles its own Node.js runtime (v20.x), which differs from your system Node.js. The `electron-rebuild` step compiles `better-sqlite3` for Electron's version. The MCP server deployment (below) compiles it separately for your system Node.js used by Claude Desktop.117118### Running the App119120```bash121# Development mode122pnpm dev:electron123124# Production build125pnpm --filter @uptier/electron build126```127128### Claude Desktop Integration129130Deploy the MCP server for Claude Desktop:131132```bash133# Deploy MCP server to standalone directory134pnpm --filter @uptier/mcp-server deploy135```136137This deploys the MCP server to `~/.uptier/mcp-server/` with its own `node_modules`, automatically compiled for your current Node.js version. The Claude Desktop config is updated automatically.138139> **Why standalone?** The Electron app uses Node.js 22 (bundled), while Claude Desktop may use a different Node.js version. The standalone deployment compiles native modules (like `better-sqlite3`) for the correct version, preventing conflicts.140141After deployment:1421. Restart Claude Desktop1432. The UpTier tools will be available in Claude144145#### Manual Configuration (Alternative)146147If the automatic deployment doesn't work, add UpTier manually to your Claude Desktop config:148149**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`150**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`151**Linux:** `~/.config/Claude/claude_desktop_config.json`152153```json154{155 "mcpServers": {156 "uptier": {157 "command": "node",158 "args": ["/path/to/.uptier/mcp-server/index.js"]159 }160 }161}162```163164## MCP Tools165166UpTier exposes powerful tools to Claude for managing your tasks:167168### Lists169| Tool | Description |170|------|-------------|171| `create_list` | Create a new task list |172| `get_lists` | Get all lists with task counts |173| `update_list` | Update list name, color, or icon |174| `delete_list` | Delete a list |175| `reorder_lists` | Change list positions |176177### Tasks178| Tool | Description |179|------|-------------|180| `create_task` | Create a new task with optional attributes |181| `get_tasks` | Get tasks with filtering options |182| `update_task` | Update task properties |183| `complete_task` | Mark task as completed |184| `delete_task` | Delete a task |185| `bulk_create_tasks` | Create multiple tasks at once |186| `move_task` | Move task to a different list |187188### Prioritization189| Tool | Description |190|------|-------------|191| `prioritize_list` | Analyze tasks and get prioritization guidance |192| `bulk_set_priorities` | Set priority tiers for multiple tasks |193| `get_prioritization_summary` | Get overview of task priorities |194| `suggest_next_task` | Get AI recommendation for what to work on next |195196### Goals197| Tool | Description |198|------|-------------|199| `create_goal` | Create a goal |200| `get_goals` | Get all goals with progress |201| `update_goal` | Update goal properties |202| `link_tasks_to_goal` | Associate tasks with goals |203| `get_goal_progress` | Get completion stats for a goal |204205### Day Planner206| Tool | Description |207|------|-------------|208| `get_day_schedule` | Get scheduled tasks, unscheduled tasks, and free time blocks for a date |209| `schedule_tasks` | Schedule tasks onto the day planner time grid |210| `unschedule_task` | Remove a task from the time grid to unscheduled sidebar |211212### Subtasks & Tags213| Tool | Description |214|------|-------------|215| `add_subtask` | Add subtask to a task |216| `update_subtask` | Update subtask properties |217| `create_tag` | Create a new tag |218| `get_tags` | Get all tags |219| `add_tag_to_task` | Tag a task |220221## Prioritization Strategies222223When asking Claude to prioritize your tasks, you can request different strategies:224225| Strategy | Best For |226|----------|----------|227| **Balanced** | General use - weighs all factors equally |228| **Urgent First** | Deadline-driven work |229| **Quick Wins** | Building momentum with low-effort wins |230| **High Impact** | Maximum results regardless of effort |231| **Eisenhower** | Classic urgent/important decision matrix |232233### Priority Tiers234235Tasks are organized into three tiers:236- **Tier 1 (Do Now)** - High impact, urgent, or blocking other work237- **Tier 2 (Do Soon)** - Important but not time-sensitive238- **Tier 3 (Backlog)** - Lower priority, someday/maybe items239240## Data Storage241242Your data is stored locally:243- **Windows:** `%APPDATA%\.uptier\tasks.db`244- **macOS/Linux:** `~/.uptier/tasks.db`245246Additional database profiles are stored in the same directory with custom names.247248The database uses SQLite with WAL mode, allowing the Electron app and MCP server to access it simultaneously without conflicts.249250### Logs251252Application logs are stored at:253- **Windows:** `%APPDATA%\UpTier\logs\`254- **macOS:** `~/Library/Application Support/UpTier/logs/`255- **Linux:** `~/.config/UpTier/logs/`256257## Keyboard Shortcuts258259| Shortcut | Action |260|----------|--------|261| `Ctrl+K` | Open command palette |262| `Ctrl+N` | Create new task |263| `Ctrl+F` | Focus search |264| `↑` / `↓` | Navigate tasks |265| `Space` | Toggle task completion |266| `Delete` | Delete selected task |267| `Escape` | Close detail panel |268269### Focus Timer Shortcuts270271| Shortcut | Action |272|----------|--------|273| `Space` | Pause/Resume timer |274| `Escape` | End focus session |275276## Roadmap277278- [x] Smart lists (My Day, Important, Planned, Completed)279- [x] Themes (Dark, Light, Earth, Cyberpunk)280- [x] Keyboard shortcuts281- [x] Tags282- [x] Due date notifications283- [x] Multiple database profiles284- [x] Data export285- [x] List rename/delete286- [x] Focus timer287- [x] Resizable panels288- [x] Recurring tasks289- [x] Custom smart list filters290- [ ] Calendar integration291- [ ] Task templates292- [ ] Mobile companion app293294## Troubleshooting295296### "Electron uninstall" error297298If you see `Error: Electron uninstall` when running `pnpm dev:electron`, the Electron binary wasn't downloaded. Run:299300```bash301node node_modules/electron/install.js302```303304### Native module errors with MCP server305306If Claude Desktop shows errors about `better-sqlite3` or `NODE_MODULE_VERSION` mismatches, use the standalone deployment:307308```bash309pnpm --filter @uptier/mcp-server deploy310```311312This creates a separate MCP server installation at `~/.uptier/mcp-server/` with native modules compiled for your current Node.js version, avoiding conflicts with the Electron app.313314If you still have issues, ensure you're running the deploy command with the same Node.js version that Claude Desktop uses (typically Node.js 23).315316### Build script warnings317318If you see warnings about "Ignored build scripts" during `pnpm install`, run:319320```bash321pnpm approve-builds322```323324Then select the packages that need to run build scripts (canvas, sharp, electron).325326### "NODE_MODULE_VERSION mismatch" in Electron app327328If the Electron app crashes with `NODE_MODULE_VERSION` mismatch (e.g., "was compiled against a different Node.js version"), rebuild `better-sqlite3` for Electron:329330```bash331npx electron-rebuild -f -w better-sqlite3332```333334This typically happens after upgrading Node.js or running `pnpm install`, which recompiles native modules for your system Node.js rather than Electron's bundled version.335336### "Schema not found" error in Claude Desktop337338If the MCP server reports that `schema.sql` cannot be found, the deployed files are stale. Rebuild and redeploy:339340```bash341pnpm --filter @uptier/shared build342pnpm --filter @uptier/mcp-server build343pnpm --filter @uptier/mcp-server deploy344```345346### After upgrading Node.js347348When you upgrade your system Node.js version, native modules need to be recompiled:3493501. **Electron app:** `npx electron-rebuild -f -w better-sqlite3`3512. **MCP server:** Rebuild and redeploy:352 ```bash353 pnpm --filter @uptier/shared build354 pnpm --filter @uptier/mcp-server build355 pnpm --filter @uptier/mcp-server deploy356 ```357358## Contributing359360Contributions are welcome! Here's how to get started:3613621. Fork the repository3632. Create a feature branch (`git checkout -b feature/amazing-feature`)3643. Make your changes3654. Run the app to test (`pnpm dev:electron`)3665. Commit your changes (`git commit -m 'Add amazing feature'`)3676. Push to the branch (`git push origin feature/amazing-feature`)3687. Open a Pull Request369370### Help Wanted: macOS & Linux Testing371372UpTier is currently only tested on Windows. If you're on macOS or Linux, we'd love your help testing and reporting any platform-specific issues!373374## License375376MIT License - see [LICENSE](LICENSE) for details.377378---379380**Built with [Electron](https://electronjs.org), [React](https://react.dev), and [Claude](https://claude.ai)**381
Full transparency — inspect the skill content before installing.