MCP server for RescueTime productivity data

What MCP server for RescueTime productivity data does

MCP server for RescueTime productivity data MCP server exposes RescueTime activity metrics to Claude through Model Context Protocol. It is designed for questions about logged time and productivity patterns, such as how productive a day was, which applications or websites consumed the most time, and how activity changed across several days.

The available operations are read-oriented. They return structured data from RescueTime rather than modifying account settings or activity records. The repository describes the server as lightweight and built with FastMCP.

How it works

MCP server for RescueTime productivity data MCP server uses the RescueTime Analytic Data API as its data source. Authentication is handled with a RescueTime API key supplied through the RESCUETIME_API_KEY environment variable. When Claude invokes a tool, the server requests the relevant data from RescueTime and returns it to the Claude session for reasoning.

The documentation states that the server does not store the data or send it elsewhere, apart from returning it to the connected Claude session. A separate plugin telemetry signal is sent once on the first load in a Claude Code session on a machine. That signal contains the plugin name and version, and can be disabled with MYCELIUM_NO_PING=1.

Setup and configuration

You need Python 3.11 or newer, FastMCP 3.x, a RescueTime account, and a RescueTime API key. The key can be created or copied from RescueTime's API management page.

The current documented installation path uses Claude Code's plugin commands:

/plugin marketplace add adelaidasofia/rescuetime-mcp
/plugin install rescuetime-mcp@rescuetime-mcp

The README also documents a legacy setup using FastMCP directly. That method installs FastMCP with pipx or uv, then registers a local server file with Claude Code using fastmcp run. The example contains a placeholder file path, so it must be replaced with the actual local server path before use. After configuration, restart Claude Code so the RescueTime tools become available.

Tools and capabilities

MCP server for RescueTime productivity data MCP server provides four tools:

• get_daily_summary reports the productivity pulse, total hours logged, and the split between productive and distracting time.
• get_top_activities ranks applications and websites by time spent.
• get_categories breaks time down into categories such as Development, Communication, and Social.
• get_productivity_trend returns the productivity pulse over a selected number of days.

Every tool accepts a day value. Supported formats are today, yesterday, and an explicit date in YYYY-MM-DD format. The trend tool additionally uses a period of N days, as indicated by its description.

Limitations and notes

The material documents access to RescueTime productivity data only; it does not describe write operations, historical data exports, custom analytics, or integrations with other services. A RescueTime account and API key are required, although the account may be free or premium. The listed examples and installation instructions target Claude Code, while the README broadly describes access from Claude. The project is licensed under MIT.

Getting started with this MCP server for RescueTime productivity data MCP server

Always refer to the official documentation for the most accurate and up-to-date information.