MCP Apps Starter Kit
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., "@MCP Apps Starter Kit Give me a 4-week strength training plan"
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.
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 dedupVideo 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:
Take a screenshot of each app in Claude Desktop
Save them in a
screenshots/folderUncomment 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.jsonAdd 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 ClaudeEach 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 |
| Registers a tool that returns |
| Serves the HTML view file to Claude Desktop |
| React hook to receive tool result data in the iframe |
| Calls MCP server tools from the iframe (e.g., save workout log) |
| Injects a message into Claude's conversation from the iframe |
| 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.tsTech Stack
MCP SDK:
@modelcontextprotocol/sdk+@modelcontextprotocol/ext-appsReact 19 with inline styles (no CSS framework needed in sandboxed iframes)
Recharts for pie/bar/line charts
Vite +
vite-plugin-singlefilefor bundling views into self-contained HTMLTypeScript for the server, JSX for views
License
MIT
Available Tools
8 toolsget_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Calorie, workout and body-weight log inside ChatGPT and Claude. Log meals by text, photo or voice.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
One workspace of tools for Claude and ChatGPT: connect 600+ apps, generate media, build tools.
Related MCP Servers
- AlicenseBqualityDmaintenancereact-mcp integrates with Claude Desktop, enabling the creation and modification of React apps based on user prompts98 npm76MIT
- AlicenseNot gradedqualityDmaintenanceA 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 npm8Apache 2.0
- AlicenseBqualityDmaintenanceA 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.3MIT
- FlicenseAqualityDmaintenanceAn 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-