activitywatch-integration

Automate ActivityWatch configuration, API queries, and data exports via REST.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/aledlie/aleph-watch --skill activitywatch-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: activitywatch-integration
Source: https://github.com/aledlie/aleph-watch/tree/main/.claude/skills/activitywatch-integration
Command: npx skills add https://github.com/aledlie/aleph-watch --skill activitywatch-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aw-client, pandas, matplotlib, requests, gspread, oauth2client, and includes references (resource) components.

What problem does it solve?

ActivityWatch generates valuable personal activity data, but accessing, analyzing, and integrating this data often requires technical expertise and manual effort. This Skill simplifies the entire process, empowering you to leverage your time-tracking data for deep insights and seamless automation without getting bogged down in complex APIs or scripting. It transforms raw data into actionable intelligence and automated workflows, allowing you to focus on your work, not on tracking it.

Core Features & Use Cases

  • Automated Data Analysis & Reporting: Effortlessly query and summarize your activity data to generate daily or weekly reports, track productivity trends, and gain insights into your work patterns.
  • Seamless External Integrations: Connect your ActivityWatch data with popular tools like Slack for daily summaries, Grafana for advanced dashboards, Google Sheets for custom tracking, or any other external service via custom scripts.
  • Custom Watcher & Automation Development: Provides a comprehensive guide and examples for building personalized activity watchers and automation flows using aw-client libraries, tailoring ActivityWatch to your unique needs.
  • Use Case: Imagine automatically receiving a Slack message each evening summarizing your top 3 most used applications and total active time. This Skill provides the tools and examples to set up such automations, saving you time and giving you instant visibility into your productivity.

Quick Start

Generate a Python script to get today's top 5 most used applications and their total durations from ActivityWatch data, and output them to the console.

Frequently Asked Questions about activitywatch-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate time tracking data analysis and generate productivity reports from ActivityWatch?

ActivityWatch automation extracts your activity data via REST API and AQL queries, then processes it with Python libraries to generate summaries—like daily app usage or active time reports. This Skill provides pre-built queries and integration templates to eliminate manual API calls and deliver insights directly to your console or external tools.

Can I connect ActivityWatch data to external tools like Slack or Google Sheets?

Yes. This Skill orchestrates ActivityWatch API integration with external platforms using gspread, requests, and custom scripts. You can push activity summaries to Slack messages, export data to Google Sheets, or feed metrics into Grafana dashboards without writing the integration from scratch.

What's the best way to build custom ActivityWatch watchers and automation workflows?

Build custom watchers using aw-client libraries and Python scripting guided by this Skill's examples and reference materials. The Skill covers watcher configuration, API usage patterns, and MCP-based orchestration so you can tailor ActivityWatch to your specific automation needs.

Do I need coding experience to set up ActivityWatch data exports and dashboards?

This Skill targets users with Python and API familiarity; it handles complex orchestration but assumes comfort with REST endpoints, AQL syntax, and script execution. Beginners may need prior exposure to these concepts, though the Skill provides guidance and templates to reduce the learning curve.

How do I synchronize ActivityWatch data across multiple devices?

Multi-device synchronization leverages ActivityWatch's REST API and server configuration to aggregate data from watchers on different machines. This Skill documents the API endpoints and data export workflows required to centralize and analyze activity from all devices in one place.

What are the limitations when exporting large volumes of ActivityWatch data?

ActivityWatch API queries and pandas processing depend on server resources and network latency. The Skill uses efficient AQL queries and data filtering to handle typical workloads, but extremely large datasets or real-time continuous export may hit API rate limits or performance constraints.