RescueTime MCP Server
Provides access to RescueTime productivity data, including daily summaries, activity tracking, productivity trends, category breakdowns, and hourly productivity analysis to monitor time usage across applications and websites.
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., "@RescueTime MCP Server How productive was I yesterday compared to today?"
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.
RescueTime MCP Server
An MCP (Model Context Protocol) server that provides Claude Desktop with access to your RescueTime productivity data, including daily summaries, activity tracking, and productivity trends.
Features
Daily Summary: Get your productivity pulse, time logged, and productive vs distracting breakdown
Productivity Trends: Track your productivity score over the past week or more
Activity Data: See which applications and websites you spent time on
Category Breakdown: View time by category (Development, Communication, etc.)
Hourly Analysis: Identify your peak productivity hours
Related MCP server: Wakapi MCP Server
Prerequisites
Python 3.11+
uv package manager
A RescueTime account (free or premium)
RescueTime API key
Setup
1. Clone and Install
git clone https://github.com/JasonBates/rescuetime-mcp.git
cd rescuetime-mcp
uv sync2. Get Your API Key
Sign in with your RescueTime account
Create a new API key or copy an existing one
3. Configure Claude Desktop
Add the server to your Claude Desktop config at:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"rescuetime": {
"command": "uv",
"args": [
"--directory",
"/Users/YOUR_USERNAME/Projects/rescuetime-mcp",
"run",
"rescuetime-mcp"
],
"env": {
"RESCUETIME_API_KEY": "your_api_key_here"
}
}
}
}Replace YOUR_USERNAME with your actual username and add your API key.
4. Restart Claude Desktop
Quit and reopen Claude Desktop. You should see "rescuetime" in the MCP servers list.
Usage
Once configured, you can ask Claude things like:
"How productive was I today?"
"Show me my productivity trend for the past week"
"What apps did I use most today?"
"What categories did I spend time on yesterday?"
"When was I most productive today?"
Available Tools
Tool | Description |
| Today's productivity pulse, time logged, and breakdown |
| Productivity score history (default 7 days) |
| Top applications/websites by time spent |
| Time spent by category |
| Productivity breakdown by hour |
Tool Details
get_today_summary
Returns a complete daily overview including:
Productivity pulse (0-100 score)
Total time logged
Productive vs distracting percentages
Breakdown by productivity level (very productive → very distracting)
get_productivity_trend
Shows daily productivity pulse with visual bars over multiple days. Useful for identifying patterns and weekly trends.
get_activity_data
Lists specific applications and websites ranked by time spent. Each activity shows:
Productivity classification ([++] to [--])
Duration
Category
get_category_breakdown
Groups time by high-level categories like Software Development, Communication, Reference & Learning, Social Networking, etc.
get_hourly_productivity
Reveals when during the day you were most/least productive. Helps identify peak hours for scheduling deep work.
Troubleshooting
"Authentication error"
Make sure your API key is correctly set in the Claude Desktop config's env section.
No data showing
RescueTime needs to be running and logging data on your devices. Check that the RescueTime app is active.
Rate limiting
The RescueTime API has rate limits. If you encounter errors, wait a few minutes before retrying.
Development
# Install dev dependencies
uv sync --dev
# Run tests
uv run pytest
# Test with MCP Inspector
npx @modelcontextprotocol/inspector uv run rescuetime-mcpLicense
MIT
Available Tools
5 toolsget_activity_dataA
Get top activities/applications by time spent.
Args: date_str: Date to query - 'today', 'yesterday', or 'YYYY-MM-DD' limit: Maximum number of activities to show (default: 10)
Shows which specific applications and websites you spent time on, ranked by duration. Includes productivity classification for each.
Inputs: date_str, limit. Returns: result
get_category_breakdownA
Get time spent by category.
Args: date_str: Date to query - 'today', 'yesterday', or 'YYYY-MM-DD'
Shows high-level categories like Software Development, Communication, Reference & Learning, etc. with time and productivity classification.
Inputs: date_str. Returns: result
get_hourly_productivityA
Get productivity breakdown by hour.
Args: date_str: Date to query - 'today', 'yesterday', or 'YYYY-MM-DD'
Shows when during the day you were most/least productive. Useful for identifying peak productivity hours and scheduling deep work.
Inputs: date_str. Returns: result
get_productivity_trendB
Get productivity pulse trend for the last N days.
Args: days: Number of days to look back (default: 7, max 14)
Shows the daily productivity pulse with visual bars and calculates averages. Useful for identifying patterns and trends over time.
Inputs: days. Returns: result
get_today_summaryA
Get today's complete RescueTime productivity summary.
This is the recommended daily check-in tool. Returns:
Productivity pulse (0-100 score)
Total time logged
Time breakdown by productivity level
Productive vs distracting percentages
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: get_activity_data focuses on specific applications/websites, get_category_breakdown on high-level categories, get_hourly_productivity on hourly patterns, get_productivity_trend on multi-day trends, and get_today_summary on a comprehensive daily overview. There is no overlap or ambiguity between these functions.
All tool names follow a consistent verb_noun pattern starting with 'get_' followed by a descriptive noun phrase (e.g., get_activity_data, get_category_breakdown). This uniformity makes the tool set predictable and easy to understand at a glance.
With 5 tools, this server is well-scoped for its purpose of providing RescueTime productivity insights. Each tool serves a unique and valuable function, covering key aspects like detailed activity data, category breakdowns, hourly analysis, trends, and daily summaries without being overwhelming or sparse.
The tool set covers the core productivity analysis domain comprehensively, including data retrieval, categorization, time-based patterns, and summaries. A minor gap is the lack of tools for modifying or configuring data (e.g., setting goals or adjusting classifications), but this is reasonable for a read-only analytics server focused on insights.
Maintenance
Related MCP Connectors
Read tracked time and projects; create projects and start or stop timers in DeskTime.
Read your WakaTime coding time: summaries, stats, projects, goals, commits and leaderboards.
Read time entries, projects, clients, tasks and invoices; log and update tracked time.
Read-only Apple Health data synced from your iPhone: sleep, heart rate, HRV, workouts and trends.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive access to RescueTime productivity data and features through the Model Context Protocol. Supports analytics retrieval, focus session management, highlights creation, and offline time tracking through natural language interactions.12MIT
- AlicenseBqualityBmaintenanceEnables tracking and analyzing development time through the Wakapi API. Provides tools to retrieve coding statistics, project details, leaderboards, and recent activity logs for productivity insights.81Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides access to WakaTime coding analytics data through MCP tools. Enables querying coding stats, activity summaries, project lists, and time tracking information from your WakaTime account.MIT
- AlicenseAqualityBmaintenanceProvides Claude access to RescueTime productivity data, enabling users to query daily summaries, top activities, category breakdowns, and productivity trends through natural language.51MIT