{ "markdown": "# RescueTime MCP Server\n\n\n\n\n

\n \"License\"\n \"GitHub\n \"Last\n \"Open\n \"PyPI\n \"PyPI\n \"Built\n

\n\n\n\nA lightweight [MCP](https://modelcontextprotocol.io/) server that gives Claude access to your [RescueTime](https://www.rescuetime.com/) productivity data. Built with [FastMCP](https://gofastmcp.com/).\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_daily_summary` | Productivity pulse, hours logged, productive vs. distracting time breakdown |\n| `get_top_activities` | Top apps/websites ranked by time spent |\n| `get_categories` | Time breakdown by category (Development, Communication, Social, etc.) |\n| `get_productivity_trend` | Productivity pulse trend over the past N days |\n\nAll tools accept a `day` parameter: `\"today\"`, `\"yesterday\"`, or `\"YYYY-MM-DD\"`.\n\n## Install\n\nOpen Claude Code, paste:\n\n /plugin marketplace add adelaidasofia/rescuetime-mcp\n /plugin install rescuetime-mcp@rescuetime-mcp\n\nThen get a RescueTime API key at [rescuetime.com/anapi/manage](https://www.rescuetime.com/anapi/manage) and set `RESCUETIME_API_KEY` in your environment.\n\n
\nLegacy install\n\n### 1. Get your API key\n\nGo to [rescuetime.com/anapi/manage](https://www.rescuetime.com/anapi/manage) and create or copy an API key.\n\n### 2. Install FastMCP\n\n```bash\npipx install fastmcp\n```\n\nOr with `uv`:\n\n```bash\nuv tool install fastmcp\n```\n\n### 3. Add to Claude Code\n\n```bash\nclaude mcp add rescuetime \\\n -e RESCUETIME_API_KEY=your_api_key_here \\\n -- fastmcp run /path/to/server.py\n```\n\nOr add manually to your `.mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"rescuetime\": {\n \"command\": \"fastmcp\",\n \"args\": [\"run\", \"/path/to/server.py\"],\n \"env\": {\n \"RESCUETIME_API_KEY\": \"your_api_key_here\"\n }\n }\n }\n}\n```\n\n### 4. Restart Claude Code\n\nThe RescueTime tools should appear in your session.\n\n
\n\n## Example Usage\n\nOnce connected, you can ask Claude things like:\n\n- \"How productive was I today?\"\n- \"What apps did I spend the most time on yesterday?\"\n- \"Show me my productivity trend for the last 7 days\"\n- \"What categories did I spend time on this week?\"\n\n## Requirements\n\n- Python 3.11+\n- [FastMCP](https://gofastmcp.com/) 3.x\n- A RescueTime account (free or premium)\n- RescueTime API key\n\n## How It Works\n\nThe server calls the [RescueTime Analytic Data API](https://www.rescuetime.com/apidoc) 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.\n\n## Related MCPs\n\nSame author, same architecture pattern (FastMCP, draft+confirm on writes where applicable, vault auto-export, MIT):\n\n- [slack-mcp](https://github.com/adelaidasofia/slack-mcp) — multi-workspace Slack\n- [imessage-mcp](https://github.com/adelaidasofia/imessage-mcp) — macOS iMessage\n- [whatsapp-mcp](https://github.com/adelaidasofia/whatsapp-mcp) — WhatsApp via whatsmeow\n- [google-workspace-mcp](https://github.com/adelaidasofia/google-workspace-mcp) — Gmail / Calendar / Drive / Docs / Sheets\n- [apollo-mcp](https://github.com/adelaidasofia/apollo-mcp) — Apollo.io CRM + sequences\n- [substack-mcp](https://github.com/adelaidasofia/substack-mcp) — Substack writing + analytics\n- [luma-mcp](https://github.com/adelaidasofia/luma-mcp) — lu.ma events\n- [parse-mcp](https://github.com/adelaidasofia/parse-mcp) — markitdown / Docling / LlamaParse router\n- [graph-query-mcp](https://github.com/adelaidasofia/graph-query-mcp) — vault knowledge graph queries\n- [graph-autotagger-mcp](https://github.com/adelaidasofia/graph-autotagger-mcp) — wikilink suggestions from the graph\n- [investor-relations-mcp](https://github.com/adelaidasofia/investor-relations-mcp) — seed-raise pipeline tracker\n- [vault-sync-mcp](https://github.com/adelaidasofia/vault-sync-mcp) — bidirectional vault sync\n\n\n## Telemetry\n\nThis plugin sends a single anonymous install signal to `myceliumai.co` the first time it loads in a Claude Code session on a given machine.\n\n**What is sent:**\n- Plugin name (e.g. `slack-mcp`)\n- Plugin version (e.g. `0.1.0`)\n\n**What is NOT sent:**\n- No user identifiers, names, emails, tokens, or API keys\n- No file paths, message content, or anything from your work\n- No IP address is stored after dedup processing\n\n**Why:** Helps the maintainer know which plugins people actually install, so attention goes to the ones that get used.\n\n**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-` — delete it if you want to reset state.\n\n## License\n\nMIT\n\n---\n\nBuilt by [Mycelium AI](https://myceliumai.co). Full install or team version at [diazroa.com](https://diazroa.com).\n", "bytes": 5979, "sha": "78dbb2bc86f0be56b7e91150e215d6efb034e28a44086a0704b2052eade48509", "repo_slug": "adelaidasofia/rescuetime-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_adelaidasofia_rescuetime_mcp_78cc0ea5/readme" }