Skip to main content
Glama

MCP Apps Starter Kit

I built these 2 mini mcp apps for my own daily use inside Claude Desktop — tracking workouts, planning trips, budgeting, comparing products, and making decisions. They turned out to be genuinely useful, so I'm putting them out here for anyone to explore, remix, or use as a starting point for their own MCP Apps.

Each app renders as a real interactive UI right inside Claude's chat — not just text, but React components with charts, forms, progress tracking, and two-way communication with Claude. If you've ever wished Claude could show you something visual instead of just describing it, this is what that looks like.

Built with the MCP Apps SDK.


The 5 Apps

Workout Tracker

"Give me a 4-week strength training plan"

This is the app I've spent the most time on — it's the most feature-rich and thoroughly tested of the five. It demonstrates what's really possible with MCP Apps:

  • Dark theme with a clean zinc + blue palette

  • Expandable exercise cards with form cues, sets/reps, and muscle group indicators

  • Progress tracking — check off exercises, log actual weights/reps, save to disk

  • Persistent history — saved to ~/.claude-workout-log.json, with automatic dedup

  • Video references — auto-fetches YouTube form guides and opens them via app.openLink()

  • Batch modifications — tweak multiple exercises, send all changes to Claude at once

  • Bidirectional chat — the app talks back to Claude to modify plans, request videos, or regenerate

Trip Planner

"I'm in Mumbai and want a 5-day vacation with a ₹50,000 budget — show me some options"

A two-phase trip planning experience. Phase 1 (Trip Explorer) shows 3-5 destination options side by side with:

  • Distance + travel modes — km away, with flight/train/drive durations from your city

  • Weather — expected temperature range and conditions

  • Budget fit — color-coded against your budget (green/yellow/red)

  • Adjustable sliders — change budget or trip duration, hit "Refresh options" to regenerate

  • Multi-select — pick up to 2 destinations to compare detailed itineraries side by side

  • Currency support — INR, USD, EUR, etc. with proper formatting

Phase 2 (Itinerary) renders a day-by-day plan where you can:

  • Swap or remove individual activities with one tap

  • Comment on any activity with specific feedback

  • Adjust trip style — quick chips like "More relaxed", "Foodie focus", or type your own

  • Queue changes and send them all to Claude at once to regenerate


The following 3 apps are work-in-progress — they render and are functional, but haven't been as heavily tested or polished. Feel free to try them out and iterate on them.

Budget Planner (WIP)

"Help me plan a $5K monthly budget"

Pie chart + bar chart breakdown of spending categories with surplus/deficit tracking. I use this whenever I want to sanity-check how I'm allocating money across categories.

Product Comparison (WIP)

"Compare MacBook Air M3 vs ThinkPad X1 Carbon"

Side-by-side cards with pros/cons, star ratings, and a "Best Pick" badge. Great for any time you're weighing two or more options — laptops, tools, services, whatever.

Decision Matrix (WIP)

"Help me decide between 3 apartments"

Weighted criteria table with heatmap-style scoring and automatic rankings. I use this for any multi-factor decision — it forces you to think about what actually matters.


Related MCP server: PopUI

Screenshots

Coming soon — I'll add screenshots showing each app running inside Claude Desktop so you can see what these look like in practice before you install them.

To add your own screenshots:

  1. Take a screenshot of each app in Claude Desktop

  2. Save them in a screenshots/ folder

  3. Uncomment the image lines in this README


Quick Start

# Clone
git clone https://github.com/rushildharhakim/mcp-apps-starter-kit.git
cd mcp-apps-starter-kit

# Install & build
npm install --legacy-peer-deps
npm run build

# Add to Claude Desktop
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "starter-kit": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-apps-starter-kit/dist/server.js"]
    }
  }
}

Restart Claude Desktop. Try any of the example prompts above.

How It Works

You type a prompt → Claude calls a render_* tool → MCP server returns structured data + UI
                                                          ↓
                                                 Claude Desktop loads the HTML view
                                                          ↓
                                                 React app renders in a sandboxed iframe
                                                          ↓
                                                 You interact → app talks back to Claude

Each view is a self-contained React app bundled into a single HTML file via Vite + vite-plugin-singlefile. The MCP server registers both a tool (to receive structured data from Claude) and a resource (to serve the HTML view to Claude Desktop).

Key SDK Patterns

API

What it does

registerAppTool()

Registers a tool that returns structuredContent + links to a UI resource

registerAppResource()

Serves the HTML view file to Claude Desktop

useApp() + ontoolresult

React hook to receive tool result data in the iframe

app.callServerTool()

Calls MCP server tools from the iframe (e.g., save workout log)

app.sendMessage()

Injects a message into Claude's conversation from the iframe

app.openLink()

Opens external URLs in the default browser (bypasses iframe sandbox)

File Structure

mcp-apps-starter-kit/
  src/
    server.ts                          # MCP server — 6 tools + 6 resources + 2 utility tools
    views/
      shared/styles.ts                 # Inline style helpers
      BudgetView.tsx                   # Pie + bar charts (Recharts)
      ComparisonView.tsx               # Side-by-side comparison grid
      TripExplorerView.tsx             # Destination comparison + selection (Phase 1)
      TripPlannerView.tsx              # Interactive day-by-day itinerary (Phase 2)
      WorkoutPlanView.tsx              # Interactive workout tracker
      DecisionMatrixView.tsx           # Weighted decision matrix + heatmap
      *.html                           # Entry points for each view
  package.json
  tsconfig.json
  vite.config.ts

Tech Stack

  • MCP SDK: @modelcontextprotocol/sdk + @modelcontextprotocol/ext-apps

  • React 19 with inline styles (no CSS framework needed in sandboxed iframes)

  • Recharts for pie/bar/line charts

  • Vite + vite-plugin-singlefile for bundling views into self-contained HTML

  • TypeScript for the server, JSX for views

License

MIT

Available Tools

8 tools
get_workout_logA

Retrieve workout history from the log file

Inputs: no named parameters.

render_budgetBudget TrackerA

Render a visual budget breakdown with pie chart of spending categories, bar chart of budget vs actual, and surplus/deficit indicator. Pass categories as a JSON array of objects with name, budgeted, and actual fields.

Inputs: categories (required), total_budget (required), title.

render_comparisonProduct ComparisonA

Render a side-by-side comparison of products or options with pros, cons, ratings, and prices. Pass options as a JSON array.

Inputs: options (required), title.

render_decision_matrixDecision MatrixA

Render a weighted decision matrix comparing options across criteria with scores, heatmap coloring, and a best-pick recommendation. Pass options and criteria as JSON arrays.

Inputs: options (required), criteria (required), title.

render_tripTrip PlannerA

Render a day-by-day trip itinerary with time slots, locations, costs, and a budget tracker. The user can swap, remove, or comment on individual activities and send style preferences (e.g. 'make it more relaxed') back to Claude. Pass itinerary as a JSON array of day objects. Use the same currency as the trip explorer if the user came from there.

Inputs: itinerary (required), title, currency, trip_days, +2 more.

render_trip_explorerTrip ExplorerA

Render an interactive destination comparison view where the user can explore 3-5 trip options side by side before committing to a detailed itinerary. Each destination MUST include: name, country, tagline, budget_estimate (low/high in the specified currency), distance_km (from source city), travel_options (object with mode keys like flight/train/drive/bus and duration string values e.g. {"flight":"2h 30m","train":"6h","drive":"8h"}), weather (object with temp_range string e.g. "22-32°C" and condition string e.g. "Sunny & humid"), best_months, highlights, travel_style tags, and image_emoji. The user can select up to 2 destinations to compare detailed itineraries side by side. Use this tool FIRST when a user asks about vacation/trip planning — let them compare destinations before calling render_trip for the detailed itinerary.

Inputs: destinations (required), title, budget, source, +2 more.

render_workoutWorkout PlanA

Render an interactive workout plan with dark theme, summary metrics, expandable exercise cards with tips and video links, progress tracking, and history. Pass plan as a JSON array of week objects. IMPORTANT: Each exercise MUST include video_url with a real YouTube link to a proper form demonstration video. Also include estimated_calories, duration_minutes, and tips (array of form cue strings).

Inputs: plan (required), title, estimated_total_calories, estimated_total_duration.

save_workout_logB

Save a completed workout session to the log file

Inputs: day (required), date (required), week (required), exercises (required), +1 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools target distinct domains (budget, comparison, trip, workout), but render_comparison and render_decision_matrix both compare options, and render_trip_explorer is also comparison-like. The detailed descriptions help clarify, but slight overlap exists.

    Naming Consistency5/5

    All render tools follow the consistent verb_noun pattern (render_budget, render_trip, etc.), and the log tools use save_workout_log/get_workout_log. Naming is uniform, snake_case, and predictable.

    Tool Count5/5

    With 8 tools, the count is well within the ideal range. Each tool appears purposeful, and there is no redundancy or bloat. The broad scope fits a 'starter kit' concept.

    Completeness2/5

    The set is a mix of render-only tools with no persistence except for workout logs (save/get). There are no update/delete operations for workout logs, and no data management for budget, comparisons, or trips. The domain is unclear, and lifecycle coverage is inconsistent.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A companion desktop app enabling bi-directional interaction between Claude Desktop and visual UI elements, allowing Claude to display, read from, and write to interactive interfaces while processing user events and feedback.
      5 npm
      8
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      A framework for building interactive UI applications and React-based widgets for ChatGPT and Claude using the Model Context Protocol. It enables developers to create custom tools and visual components that facilitate rich, bidirectional interaction between AI models and users.
      3
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      An MCP App that renders an interactive dashboard in Claude conversations to unify calendar events, emails, and documents into a single interface. It enables users to manage their daily schedule and perform actions like meeting preparation through bidirectional communication between the UI and the model.
      2
      -