gwb-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GWB_TOKEN | No | Token copied from the phone app (`设置 → 电脑协同`). Normally stored once via `gwb token <token>` (written to ~/.config/gwb/config.json, mode 0600); this environment variable overrides the stored token, useful for temporary or multi-machine setups. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingA | 检查链路是否活着,并返回各表条数与手机端协议版本。第一次调用会扫蓝牙(约 3 秒)。 |
| list_todosA | 列出待办,顺序与手机待办页一致:未完成在前、新的在上。 only: all(默认,含全部完成历史)/ open(只看未完成)/ today(未完成 + 今天完成的, 就是手机待办页上肉眼可见的那些)。历史会一直长,只想找活的时候用 open。 |
| list_habitsA | 列出全部习惯,含当前计数 current_count / 目标 target_count 与今日是否达标。 |
| list_countdownsA | 列出全部倒计时,按到期时间升序;target_at 是本地时间字符串。 |
| add_todoB | 新建一条待办,返回它的 id。 icon 取 CartoonIcons 的 key(scroll book cup dumbbell dog cat star apple music flame moon sun pencil flower sprout file heart bolt basketball coffee cloud cherry fish gamepad bulb gift clock),默认 scroll。 color 是图标底色下标 0..7。timing 为 none / forward / countdown,countdown 时用 minutes 给时长(分钟)。 |
| update_todoA | 改一条待办的标题/图标/颜色/计时模式;没传的字段保持原样,完成状态不受影响。 只想改标题就别用 add_todo —— 那会带上一个新 id 造出第二条。 |
| set_todo_doneA | 把待办标记完成(done=true)或改回未完成(done=false)。完成日按手机当前日历日记。 |
| delete_todoA | 删除一条待办。必须传 confirm=true —— 不可恢复,删除前先和用户确认。 |
| add_habitB | 新建一个习惯,返回它的 id。target_count 为每日目标次数(1..99,默认 1)。 |
| update_habitB | 改一个习惯的标题/目标次数/单位/图标/颜色;没传的字段保持原样,今日计数不受影响。 |
| check_habitB | 打卡一次:默认 +1(已达标时 −1,与手机上点一下的行为一致),delta 可显式指定增减。 |
| delete_habitA | 删除一个习惯。必须传 confirm=true —— 不可恢复,删除前先和用户确认。 |
| add_countdownC | 新建倒计时。when 是本地时间、无时区,形如 2026-11-20T09:00 或 2026-11-20T09:00:00。 |
| update_countdownA | 改一个倒计时的标题/到期时间/颜色;没传的字段保持原样。 |
| delete_countdownA | 删除一个倒计时。必须传 confirm=true —— 不可恢复,删除前先和用户确认。 |
| today_summaryA | 今天的一帧全景(需要 app 3.8+):待办未完成/今日完成、习惯达标数、喝水 ml/目标、 昨夜睡眠分钟 + 连续达标天数 + 最近一次记录、今日专注轮次/分钟、最近的倒计时。 回答「今天怎么样」只需这一次调用,不要拿四张表拼。 |
| log_waterA | 记一杯水(需要 app 3.8+)。ml 省略时用手机上第一个快捷杯量(默认 150)。 返回今日累计 today_ml 与目标 goal_ml。 |
| water_todayA | 今天的喝水明细(需要 app 3.8+):总量、目标、快捷杯量、每一条记录。 |
| list_sleepA | 最近的睡眠记录(需要 app 3.8+),按醒来时间倒序,默认 14 天窗口。 minutes 是单次时长;day 是这条被归到的日历日(醒来的那天),今天的总量看 today_minutes。 |
| log_sleepB | 补一条睡眠记录(需要 app 3.8+):两个端点都是本地时间、无时区, 形如 2026-11-04T23:00。wake_at 必须晚于 sleep_at 且不能是未来。 |
| focus_todayA | 今天的专注统计(需要 app 3.8+):轮次、总分钟,以及按待办分组的分钟数。 |
| disconnectA | 主动断开蓝牙连接(省手机电)。下次工具调用会自动重连。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 22 tools
Tools are cleanly separated by resource (todo/habit/countdown/water/sleep/focus) and action, and the read-vs-write pairs (water_today vs log_water, list_sleep vs log_sleep) are clearly distinguishable. The only real overlap is today_summary versus the per-domain readers, but its description explicitly tells the agent to use it alone instead of stitching four tables together.
All names are lowercase snake_case with a predictable verb_noun shape for the CRUD set (list/add/update/delete_todo, set_todo_done, check_habit, log_water), plus a repeated *_today read pattern. Minor deviations (ping, disconnect, and the word-order split between water_today/focus_today and today_summary) keep it from a perfect score.
22 tools is on the heavy side, but the surface spans six distinct domains (todos, habits, countdowns, water, sleep, focus) plus connection handling, so most tools pull their weight. Still, several domains carry full four-tool CRUD blocks where a leaner aggregate could have reduced the set.
Todos, habits and countdowns have full create/update/delete lifecycles, but the logging domains are one-way: water and sleep can be logged and read but never corrected or deleted, and focus is read-only with no per-item get for any resource. An agent that mis-logs a water cup or sleep entry has no recovery path.