@cpenned/mcp 0.5.0 → 0.6.0

package/README.md

@@ -82,6 +82,14 @@ Point the `args` at the absolute `packages/mcp/dist/index.js` path with
   independently of status), `delete_reading_item` (true soft delete, hidden
   everywhere; restore with `{deleted: false}`), `add_reading_tags`/
   `remove_reading_tags`.
+- **Strava**: `list_strava_activities`, `get_strava_activity`,
+  `update_strava_activity` (`notes`/`archived`/`deleted` only — everything
+  else is Strava-authoritative), `delete_strava_activity` (soft delete;
+  restore with `{deleted: false}`), `add_strava_activity_tags`/
+  `remove_strava_activity_tags`, `sync_strava_activities` (manual
+  backfill/fallback; real-time ingestion is a webhook). No create tool —
+  activities only arrive via webhook or sync. Requires connecting a Strava
+  account first, from the web app's Settings page.
 - **Views & reviews**: `get_view`, `get_reviews`, `review_garden`,
   `request_garden_review`, `mark_task_reviewed`, `mark_project_reviewed`.
 - **Settings**: `get_settings`, `update_settings` — the default review period

package/dist/tools/index.js

@@ -6,6 +6,7 @@ import { registerPeopleTools } from "./people.js";
 import { registerProjectTools } from "./projects.js";
 import { registerReadingTools } from "./reading.js";
 import { registerSettingsTools } from "./settings.js";
+import { registerStravaTools } from "./strava.js";
 import { registerTagTools } from "./tags.js";
 import { registerTaskTools } from "./tasks.js";
 import { registerUiTools } from "./ui.js";
@@ -17,6 +18,7 @@ export function registerAllTools(server, client) {
     registerTagTools(server, client);
     registerPeopleTools(server, client);
     registerReadingTools(server, client);
+    registerStravaTools(server, client);
     registerListTools(server, client);
     registerViewTools(server, client);
     registerAiTools(server, client);

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAuB;IACzE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAuB;IACzE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/tools/strava.js

@@ -0,0 +1,124 @@
+// Strava activity tools. Activities are never created here - they're only
+// ingested via webhook or sync_strava_activities (a manual/backfill trigger).
+// Every other field except title/notes/archived/deleted/tags is
+// Strava-authoritative and rejected by update_strava_activity's underlying
+// endpoint if attempted.
+// GPS/speed streams aren't exposed as a tool - they're large binary-ish data
+// meant for the web UI's map, not an agent's context; get_strava_activity
+// exposes hasStreams so an agent can point the user at the web UI to view it.
+import { z } from "zod";
+import { runTool } from "../result.js";
+const listStravaActivitiesSchema = z.object({
+    ids: z.array(z.string()).optional(),
+    tagIds: z.array(z.string()).optional(),
+    type: z.string().optional().describe("Strava activity type, e.g. Run, Ride, Swim"),
+    query: z
+        .string()
+        .optional()
+        .describe("Case-insensitive substring search over name/notes/tags"),
+    limit: z.number().int().positive().optional(),
+    includeArchived: z
+        .boolean()
+        .optional()
+        .describe("Include archived activities. Defaults to false"),
+});
+export function listStravaActivities(client, args) {
+    return client.get("/v1/strava/activities", {
+        ids: args.ids?.length ? args.ids.join(",") : undefined,
+        tag: args.tagIds?.length ? args.tagIds.join(",") : undefined,
+        type: args.type,
+        q: args.query,
+        limit: args.limit,
+        includeArchived: args.includeArchived,
+    });
+}
+const getStravaActivitySchema = z.object({ id: z.string() });
+export function getStravaActivity(client, args) {
+    return client.get(`/v1/strava/activities/${args.id}`);
+}
+const updateStravaActivitySchema = z.object({
+    id: z.string(),
+    title: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Overrides the Strava-synced name for display; null reverts to it."),
+    notes: z.string().optional(),
+    archived: z
+        .boolean()
+        .optional()
+        .describe("Find-later flag; true hides it from the default list (unless includeArchived), false restores it."),
+    deleted: z
+        .boolean()
+        .optional()
+        .describe("true deletes (same as delete_strava_activity, hidden everywhere); false restores."),
+});
+export function updateStravaActivity(client, args) {
+    const { id, ...patch } = args;
+    return client.patch(`/v1/strava/activities/${id}`, patch);
+}
+const deleteStravaActivitySchema = z.object({ id: z.string() });
+export function deleteStravaActivity(client, args) {
+    return client.del(`/v1/strava/activities/${args.id}`);
+}
+const stravaActivityTagsSchema = z.object({
+    id: z.string(),
+    tagIds: z.array(z.string()),
+});
+export function addStravaActivityTags(client, args) {
+    return client.post(`/v1/strava/activities/${args.id}/tags`, { tagIds: args.tagIds });
+}
+export function removeStravaActivityTags(client, args) {
+    return client.request("DELETE", `/v1/strava/activities/${args.id}/tags`, {
+        body: { tagIds: args.tagIds },
+    });
+}
+const syncStravaActivitiesSchema = z.object({
+    sinceDays: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Only import activities from the last N days. Omit to sync all history."),
+});
+export function syncStravaActivities(client, args) {
+    return client.post("/v1/strava/sync", args);
+}
+export function registerStravaTools(server, client) {
+    server.registerTool("list_strava_activities", {
+        title: "List Strava activities",
+        description: "List Strava activities, multi-get by ids, or filter by tags/type/query. Archived activities are excluded unless includeArchived is set.",
+        inputSchema: listStravaActivitiesSchema.shape,
+    }, (args) => runTool(() => listStravaActivities(client, args)));
+    server.registerTool("get_strava_activity", {
+        title: "Get Strava activity",
+        description: "Fetch one Strava activity with its tags. Use hasStreams to know whether a GPS/speed map is available in the web UI.",
+        inputSchema: getStravaActivitySchema.shape,
+    }, (args) => runTool(() => getStravaActivity(client, args)));
+    server.registerTool("update_strava_activity", {
+        title: "Update Strava activity",
+        description: "Update a Strava activity's title (override the synced name; null reverts to it), notes, archived (find-later flag), or deleted. Every other field (distance, etc.) is Strava-authoritative and can't be edited here.",
+        inputSchema: updateStravaActivitySchema.shape,
+    }, (args) => runTool(() => updateStravaActivity(client, args)));
+    server.registerTool("delete_strava_activity", {
+        title: "Delete Strava activity",
+        description: "Soft-delete a Strava activity (hidden everywhere). Restore with update_strava_activity {deleted: false}.",
+        inputSchema: deleteStravaActivitySchema.shape,
+    }, (args) => runTool(() => deleteStravaActivity(client, args)));
+    server.registerTool("add_strava_activity_tags", {
+        title: "Tag Strava activity",
+        description: "Attach tags to a Strava activity.",
+        inputSchema: stravaActivityTagsSchema.shape,
+    }, (args) => runTool(() => addStravaActivityTags(client, args)));
+    server.registerTool("remove_strava_activity_tags", {
+        title: "Untag Strava activity",
+        description: "Detach tags from a Strava activity.",
+        inputSchema: stravaActivityTagsSchema.shape,
+    }, (args) => runTool(() => removeStravaActivityTags(client, args)));
+    server.registerTool("sync_strava_activities", {
+        title: "Sync Strava activities",
+        description: "Manually pull recent activities from Strava (backfill/fallback alongside the real-time webhook). Capped per call; re-run to continue further back in history.",
+        inputSchema: syncStravaActivitiesSchema.shape,
+    }, (args) => runTool(() => syncStravaActivities(client, args)));
+}
+//# sourceMappingURL=strava.js.map

package/dist/tools/strava.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strava.js","sourceRoot":"","sources":["../../src/tools/strava.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cpenned/mcp",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "MCP server for Open Brain - a thin adapter over the /v1 HTTP API.",
   "type": "module",
   "license": "MIT",

package/skills/open-brain-mcp/SKILL.md

@@ -59,6 +59,17 @@ pre-guessing constraints.
   `add_reading_tags`/`remove_reading_tags`; person links live on the person
   side (`add_person_links`/`remove_person_links` with `readingListItemIds`),
   not here.
+- **Strava activity** = a GPS-tracked activity mirrored in from Strava
+  (real-time webhook, plus `sync_strava_activities` for backfill/fallback).
+  Never created here — every field except `notes`, `archived`, `deleted`, and
+  tags is Strava-authoritative and rejected if you try to patch it.
+  `detailStatus` (`pending|ready|failed`) tracks the async enrichment fetch;
+  `hasStreams` tells you whether a GPS/speed map is available (streams land
+  slightly after the summary, so a just-synced activity may briefly show
+  `hasStreams: false`). `archived`/`deleted` are independent booleans, same
+  reversible semantics as reading list items. GPS/speed stream data itself
+  isn't exposed as a tool (too large for an agent's context) — point the user
+  at the web UI's activity detail page to see the map.
 
 ## Tool catalog
 
@@ -91,6 +102,14 @@ pre-guessing constraints.
   `archived`/`deleted` toggle independently of status), `delete_reading_item`
   (true soft delete, hidden everywhere; restore with `update_reading_item
   {deleted: false}`), `add_reading_tags`/`remove_reading_tags`.
+- **Strava**: `list_strava_activities` (filter by `tagIds`/`type`/`query`, or
+  multi-get via `ids`; archived excluded unless `includeArchived`),
+  `get_strava_activity`, `update_strava_activity` (`notes`/`archived`/
+  `deleted` only), `delete_strava_activity` (soft delete; restore with
+  `update_strava_activity {deleted: false}`),
+  `add_strava_activity_tags`/`remove_strava_activity_tags`,
+  `sync_strava_activities` (manual backfill; optional `sinceDays`; capped per
+  call — re-run to pull further back in history).
 - **Saved lists** (named, reusable task-list filters): `list_saved_lists`,
   `create_saved_list`, `update_saved_list`, `delete_saved_list`.
 - **Views & reviews**: `get_view` (today/upcoming/overdue, timezone-aware),
@@ -173,10 +192,13 @@ pre-guessing constraints.
   from the web app's Settings page, not `apiKeys:bootstrap`.
 - Scopes gate tools: resource tools need `<resource>:read|write` (people tools
   `people:read|write`, settings tools `settings:read|write`, reading list tools
-  `reading:read|write`), review tools `reviews:*`, `find_tasks`/`ai_triage` need
-  `ai:invoke`, the `*_key` tools need `keys:manage`. A missing scope returns a
-  403 tool error. Keys minted before a feature shipped won't carry its scope
-  unless they hold `*`.
+  `reading:read|write`, Strava tools `strava:read|write`), review tools
+  `reviews:*`, `find_tasks`/`ai_triage` need `ai:invoke`, the `*_key` tools
+  need `keys:manage`. A missing scope returns a 403 tool error. Keys minted
+  before a feature shipped won't carry its scope unless they hold `*`.
+- `sync_strava_activities` requires a Strava account already connected (via
+  the web UI's Settings page) — it does nothing useful if nobody has
+  authorized the app yet.
 - `create_reading_item`'s title/description fetch is best-effort and
   asynchronous — a failed fetch (unreachable page, timeout, non-HTML response)
   silently leaves the item with its URL as the title; this is expected, not a