Authenticate with Basecamp via OAuth. Opens a browser window for authorization. If you have multiple Basecamp accounts, call first without account_id to see the list, then call again with the desired account_id.

Remove stored Basecamp credentials.

Check login state: show whether you're authenticated and, if so, the basic Basecamp user + account id. For your full profile (id, title, attachable_sgid) use basecamp_get_me.

List all projects visible to the authenticated user in a Basecamp account. This tool returns active projects with their IDs, names, descriptions, and metadata. Use this to discover project/bucket IDs needed for accessing messages, todos, and other resources.

Fetch detailed information about a specific Basecamp project. This tool retrieves complete project details including name, description, dock configuration, and metadata.

Examples:

• Use when: "Get details for project 12345"

• Use when: Need full project information including dock configuration

Retrieve a single message from a Basecamp message board.

List messages in a Basecamp message board (a single project). For cross-project or time-based browsing across content types, use basecamp_list_recordings instead.

List available message types/categories for a Basecamp project

Create a new message in a Basecamp message board.

Update a message. Use partial content operations when possible to save on token usage.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

Get todo set container for a project. Returns todo lists and groups.

List todos in a todo list. Filter by status: 'active' or 'archived'.

Create a new todo item in a todo list.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

Mark a todo as completed.

Mark a todo as incomplete (undo completion).

Update a todo item. Use partial content operations when possible to save on token usage.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

List comments on any Basecamp resource (message, todo, card, etc.). Works universally on all recording types.

Add a comment to any Basecamp resource (message, todo, card, etc.).

Update a comment. Use partial content operations when possible to save on token usage.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

Get your full profile for the authenticated user (id, name, email, title, attachable_sgid). To simply check whether you're logged in, use basecamp_whoami.

List all people in the Basecamp account.

Get details about a specific person.

List all columns in a kanban board.

List cards in a kanban column.

Get all details of a specific kanban card.

Create a new card in a kanban column with optional checklist steps.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

Update a kanban card including its steps. At least one field (title, content, partial content operations, or steps) must be provided. Use partial content operations when possible to save on token usage.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

Move a kanban card to a different column and/or position within that column.

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"]

Browse chat messages from Basecamp Campfires. Campfires are real-time chat rooms within projects.

Use this tool to:

• See recent chat activity across all campfires or specific ones

• Find messages from specific people

• Search message content for keywords

• Review chat history since a specific date or time period

All filters support multiple values for OR-matching.

Examples:

• "What's been discussed in chat today?" → since: "today"

• "Show messages from Alice and Bob" → person_ids: [111, 222]

• "Find chat messages mentioning deploy or release" → query: ["deploy", "release"]

• "Recent messages in campfire 12345" → campfire_ids: [12345]

List sub-vaults (folders) under a parent vault in the Docs & Files section.

Get details of a vault (folder) including document/upload/sub-vault counts.

Create a new vault (folder) under a parent vault.

Update the title of a vault (folder).

List documents in a vault.

Retrieve a single document with its full content.

Create a new document in a vault.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

Update a document. Use partial content operations when possible to save on token usage.

HTML rules for content:

• Allowed tags: p, span, h2, h3, h4, br, strong, em, strike, code, a (with href attribute), pre, ol, ul, li, blockquote, mark, figure, figcaption, table, tbody, tr, th, td, div, bc-attachment.

• Use for paragraphs. Use for empty line spacing between paragraphs.

• Headings: use , , as appropriate.

• Inline code: text. Preformatted blocks: text.

• Ordered lists: .... Unordered: ....

• Tables: Heading...Cell...

• To mention people:

• Single image:

• Image gallery: wrap multiple in a .

• Basecamp auto-enriches bc-attachment tags after saving (adds url, href, filename, content-type, etc.) — you never need to write those.

• To consume less tokens, existing tags can be rewritten keeping only: sgid, presentation, caption. For mentions also keep content-type="application/vnd.basecamp.mention". Drop everything else including inner HTML.

• Background highlights: ...

• Text color highlights: ...

• For both, N is 1 (yellow), 2 (amber), 3 (red), 4 (pink), 5 (purple), 6 (blue), 7 (teal), 8 (near-white), or 9 (light gray).

List files uploaded to a vault in the Docs & Files section.

Get a file uploaded to a vault. For images, returns the image content that the LLM can see directly. For text-based files (plain text, CSV, JSON, XML, etc.), returns the file content as text. For other binary formats, returns metadata only.

Download an inline attachment from a tag found in document/message/comment HTML content. Extract the blob_id and filename from the href attribute (format: https://storage.3.basecamp.com/{accountId}/blobs/{blobId}/download/{filename}). For images, returns the image content that the LLM can see directly. For text-based files, returns the file content as text.

Get the questionnaire (check-ins container) for a project. Returns the number of questions and their URL.

List all automatic check-in questions in a questionnaire. Returns each question's title, schedule, paused status, and answer count.

Get a single automatic check-in question with its schedule and metadata.

List answers to a specific check-in question. Returns each answer's content, author, and check-in date.

Get a single check-in answer by its ID.

Create a new answer for a check-in question. Content must be HTML.