RescueTime MCP Server
<!-- mycelium-badges:start --> <p> <a href="https://github.com/adelaidasofia/rescuetime-mcp/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/adelaidasofia/rescuetime-mcp?color=blue"></a> <a href="https://github.com/adelaidasofia/rescuetime-mcp/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/adelaidasofia/rescuetime-mcp?color=eab308"></a> <a href="https://github.com/adelaidasofia/rescuetime-mcp/commits/main"><img alt="Last commit" src="https://img.shields.io/github/last-commit/adelaidasofia/rescuetime-mcp"></a> <a href="https://github.com/adelaidasofia/rescuetime-mcp/issues"><img alt="Open issues" src="https://img.shields.io/github/issues/adelaidasofia/rescuetime-mcp"></a> <a href="https://pypi.org/project/adelaidasofia-rescuetime-mcp/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/adelaidasofia-rescuetime-mcp?color=blue&label=pypi"></a> <a href="https://pypi.org/project/adelaidasofia-rescuetime-mcp/"><img alt="PyPI downloads" src="https://img.shields.io/pypi/dm/adelaidasofia-rescuetime-mcp?color=blue&label=downloads"></a> <a href="https://myceliumai.co"><img alt="Built by Mycelium AI" src="https://img.shields.io/badge/built_by-Mycelium_AI-15B89A"></a> </p> <!-- mycelium-badges:end -->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".
Install
Open Claude Code, paste:
/plugin marketplace add adelaidasofia/rescuetime-mcp
/plugin install rescuetime-mcp@rescuetime-mcp
Then get a RescueTime API key at rescuetime.com/anapi/manage and set RESCUETIME_API_KEY in your environment.
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.
</details>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.
Related MCPs
Same author, same architecture pattern (FastMCP, draft+confirm on writes where applicable, vault auto-export, MIT):
- slack-mcp — multi-workspace Slack
- imessage-mcp — macOS iMessage
- whatsapp-mcp — WhatsApp via whatsmeow
- google-workspace-mcp — Gmail / Calendar / Drive / Docs / Sheets
- apollo-mcp — Apollo.io CRM + sequences
- substack-mcp — Substack writing + analytics
- luma-mcp — lu.ma events
- parse-mcp — markitdown / Docling / LlamaParse router
- graph-query-mcp — vault knowledge graph queries
- graph-autotagger-mcp — wikilink suggestions from the graph
- investor-relations-mcp — seed-raise pipeline tracker
- vault-sync-mcp — bidirectional vault sync
Telemetry
This plugin sends a single anonymous install signal to myceliumai.co the first time it loads in a Claude Code session on a given machine.
What is sent:
- Plugin name (e.g.
slack-mcp) - Plugin version (e.g.
0.1.0)
What is NOT sent:
- No user identifiers, names, emails, tokens, or API keys
- No file paths, message content, or anything from your work
- No IP address is stored after dedup processing
Why: Helps the maintainer know which plugins people actually install, so attention goes to the ones that get used.
Opt out: Set the environment variable MYCELIUM_NO_PING=1 before launching Claude Code. The hook will skip the network call entirely. Already-pinged installs leave a sentinel at ~/.mycelium/onboarded-<plugin> — delete it if you want to reset state.
License
MIT
Built by Mycelium AI. Full install or team version at diazroa.com.