RescueTime Server

A lightweight MCP server that gives Claude access to your RescueTime productivity data. Built with FastMCP.

Tools

Tool	Description
get_daily_summary	Productivity pulse, hours logged, productive vs. distracting time breakdown
get_top_activities	Top apps/websites ranked by time spent
get_categories	Time breakdown by category (Development, Communication, Social, etc.)
get_productivity_trend	Productivity pulse trend over the past N days

All tools accept a day parameter: "today", "yesterday", or "YYYY-MM-DD".

Setup

1. Get your API key

Go to rescuetime.com/anapi/manage and create or copy an API key.

2. Install FastMCP

pipx install fastmcp

Or with uv:

uv tool install fastmcp

3. Add to Claude Code

claude mcp add rescuetime \
  -e RESCUETIME_API_KEY=your_api_key_here \
  -- fastmcp run /path/to/server.py

Or add manually to your .mcp.json:

{
  "mcpServers": {
    "rescuetime": {
      "command": "fastmcp",
      "args": ["run", "/path/to/server.py"],
      "env": {
        "RESCUETIME_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. Restart Claude Code

The RescueTime tools should appear in your session.

Example Usage

Once connected, you can ask Claude things like:

• "How productive was I today?"
• "What apps did I spend the most time on yesterday?"
• "Show me my productivity trend for the last 7 days"
• "What categories did I spend time on this week?"

Requirements

• Python 3.11+
• FastMCP 3.x
• A RescueTime account (free or premium)
• RescueTime API key

How It Works

The server calls the RescueTime Analytic Data API using your API key and returns structured productivity data that Claude can reason about. No data is stored or sent anywhere except back to your Claude session.

License

MIT