activitywatch-mcp-server

Name: activitywatch-mcp-server
Rating: 2.3 (65 reviews)
Author: 8bitgentleman

by 8bitgentleman·★ 65·综合分 46

ActivityWatch 时间追踪数据的 MCP 服务器，让 LLM 能够查询并与之交互。

productivityai-llmmonitoring

Forks

活跃 Issue

1 个月前

概述

ActivityWatch MCP 服务器连接到 ActivityWatch 时间追踪应用，并通过 MCP 协议将其数据和查询功能暴露给 LLM。用户可以检索时间追踪数据、使用 ActivityWatch 查询语言运行查询、访问存储桶信息以及获取设置。该服务器使用 TypeScript 编写，提供 npm 安装和源码构建两种方式，并有详细的文档说明各种使用场景和环境配置。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

你:生产力分析：查询时间追踪数据，了解在不同应用程序和活动中花费的时间

你:个人洞察：通过 AI 界面提出关于时间使用模式的问题，获取详细的 ActivityWatch 报告

你:自动化报告：通过 MCP 运行复杂 AQL 查询，提取特定的时间追踪指标创建自定义报告

你:最常见的查询格式错误是什么？

你:如何连接到在不同主机上运行的 ActivityWatch？

什么时候选它

如果你使用ActivityWatch进行时间追踪，并希望通过Claude中的自然语言提示查询数据，请选择此服务器。

什么时候不要选它

如果你不使用ActivityWatch、需要实时数据访问或需要更全面的分析解决方案，请避免使用此工具。

此 server 暴露的工具

从 README 抽取出 4 个工具

list-buckets
Lists all available ActivityWatch buckets with optional type filtering
run-query
Run a query in ActivityWatch's query language (AQL)
get-events
Get raw events from an ActivityWatch bucket
get-settings
Get ActivityWatch settings from the server

可对比工具

watchtime-mcptimetagger-mcprescue-time-mcp

安装

**从 npm 安装（即将推出）：**

npm install -g activitywatch-mcp-server

**从源码构建：**

克隆仓库
npm install
npm run build

配置

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "activitywatch": {
      "command": "activitywatch-mcp-server",
      "args": []
    }
  }
}

如果从源码构建：

{
  "mcpServers": {
    "activitywatch": {
      "command": "node",
      "args": ["/path/to/activitywatch-mcp-server/dist/index.js"]
    }
  }
}

FAQ

最常见的查询格式错误是什么？: 最常见的错误是将查询语句拆分为单独的数组元素，而不是将它们合并为一个字符串。所有语句都应该在查询数组中的一个字符串中。
如何连接到在不同主机上运行的 ActivityWatch？: 使用环境变量 AW_API_BASE 或 --aw-api-base 标志：`export AW_API_BASE=http://mydesktop.local:5600/api/0`

activitywatch-mcp-server 对比

activitywatch-mcp-server vs ultimate_mcp_server activitywatch-mcp-server vs mcp-server-chart activitywatch-mcp-server vs everything activitywatch-mcp-server vs filesystem activitywatch-mcp-server vs time

GitHub →

最后更新于 2026-05-17 · 由 README + GitHub 公开数据自动生成。