BC4 Basecamp Integration

Claude can interact with Basecamp via the bc4 command-line tool, enabling management of:

• Todos: Create, view, check/uncheck, edit, and organize todos

• Cards: Manage kanban-style card tables for workflow tracking

• Messages: Post announcements and updates to projects

• Campfires: Team chat functionality

• Comments: Add comments to any Basecamp resource

Quick Reference

Check Authentication & Context

bc4 auth status # Verify authentication bc4 profile # Show current user bc4 project list # List available projects bc4 project select # Interactively select default project

Todos

bc4 todo lists # List all todo lists in project bc4 todo list "List Name" # View todos in a specific list bc4 todo list --grouped # Show todos grouped by sections bc4 todo view <id> # View todo details bc4 todo add "Task description" # Create a new todo bc4 todo check <id> # Mark complete bc4 todo uncheck <id> # Mark incomplete bc4 todo edit <id> # Edit a todo

Cards (Kanban Boards)

bc4 card list # List card tables in project bc4 card table "Table Name" # View cards in a table bc4 card view <id> # View card details with steps bc4 card add "Card title" # Quick card creation bc4 card move <id> --column "Col" # Move card to column bc4 card assign <id> # Assign people to card bc4 card step list <card-id> # List steps on a card

Messages & Campfire

bc4 message post # Post a message (interactive) bc4 campfire post "Update" # Quick team chat message

Comments

bc4 comment add <resource-type> <id> "Comment text"

Global Flags

These flags work with any bc4 command:

• --json

• Output in JSON format (useful for parsing)

• --project <id>

• Override default project

• --account <id>

• Override default account

• --verbose

• Enable debug output

• --no-color

• Disable colored output

Workflow Guidelines

• Always verify context first: Run bc4 project list or check authentication if unsure about the current project

• Use descriptive names: When creating todos or cards, include clear, actionable descriptions

• Check before acting: View items with bc4 todo view or bc4 card view before editing

• JSON output: Use --json flag when you need to parse or process the output programmatically

Common Patterns

When the user asks to:

• See what's on a card: Use bc4 card view <id> to see full details including steps

• Complete a task: Use bc4 todo check <id> to mark it done

• Update a card's status: Use bc4 card move <id> --column "Done"

• Add a comment: Use bc4 comment add card <id> "Comment text"

• Find a specific todo/card: Use bc4 todo list or bc4 card table with grep if needed

For detailed command documentation, see commands.md. For workflow examples, see examples.md.