List Basecamp Activity (Recordings)
basecamp_list_recordingsBrowse recent activity across Basecamp projects by listing all content types (todos, messages, documents, comments, uploads). Filter by project, person, time, type, title text, and more to find specific updates.
Instructions
Browse recent activity across Basecamp by listing recordings. Recordings represent all content in Basecamp: todos, messages, documents, comments, uploads, and more.
Use this tool to:
See what's been happening across all projects or specific projects
Find recent activity by one or more people
Review changes since a specific date or time period
Filter activity by content type (todos, messages, documents, etc.)
Search activity by title text
When to use this vs. the per-resource list tools: use the per-project list tools (basecamp_list_messages, basecamp_list_todos, basecamp_list_documents, basecamp_list_comments, basecamp_list_kanban_cards) to browse items WITHIN a single project; use basecamp_list_recordings for CROSS-project, time-based, or multi-type activity browsing.
All filters support multiple values for OR-matching.
Examples:
"What happened in the last 24 hours?" → since: "24h"
"Show recent todos in project 12345" → project_ids: [12345], type: ["todo"]
"What did Alice and Bob do this week?" → person_ids: [111, 222], since: "7d"
"Find messages mentioning launch across projects 1 and 2" → project_ids: [1, 2], type: ["message"], query: ["launch"]
"Find items about design or UX" → query: ["design", "UX"]
"List all messages across projects" → type: ["message"]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_ids | No | Filter to specific projects (bucket IDs). Supports multiple IDs for OR-matching. Omit to browse across all projects. | |
| type | No | Recording type filter. Options: "todo", "message", "document", "comment", "upload", "todolist", "question", "schedule", "vault". Supports multiple values for OR-matching. Omit to fetch all common types (todo, message, document, comment, upload, card). | |
| since | No | Show activity since this time. Accepts ISO 8601 dates (e.g., "2024-01-15"), relative durations ("24h", "7d", "2w"), or keywords ("today", "yesterday"). | |
| person_ids | No | Filter by creator person IDs. Supports multiple IDs for OR-matching. Use basecamp_list_people to find person IDs. | |
| query | No | Case-insensitive text search against recording titles. Supports multiple terms for OR-matching. | |
| sort | No | Sort field: "created_at" (default) or "updated_at". | |
| direction | No | Sort direction: "desc" (default, newest first) or "asc" (oldest first). | |
| status | No | Recording status filter: "active" (default), "archived", or "trashed". | |
| limit | No | Maximum number of recordings to return (default: 20, max: 100). |