Basecamp

Basecamp MCP Server for Cloudflare Workers

Available Tools

65 tools available in the Basecamp MCP server. Each tool can be called by AI assistants to perform specific actions.

basecamp_trash_project

Move a Basecamp project to trash.

Args:

projectId: Project ID to trash

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "projectId": {
      "type": "number",
      "description": "Project ID to trash"
    }
  }
}

basecamp_uncomplete_todo

Mark a to-do as incomplete.

Args:

projectId: The project ID
todoId: The to-do ID

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "projectId",
    "todoId"
  ],
  "properties": {
    "todoId": {
      "type": "number",
      "description": "Todo ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_list_campfires

List all Campfires visible to the current user.

Returns: Paginated list of all Campfires across projects.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

basecamp_get_campfire

Get a Campfire by ID.

Args:

projectId: The project ID
campfireId: The Campfire ID
format: Response format

Returns: The Campfire with topic and lines URL.

{
  "type": "object",
  "required": [
    "projectId",
    "campfireId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "campfireId": {
      "type": "number",
      "description": "Campfire ID"
    }
  }
}

basecamp_list_campfire_lines

List chat messages in a Campfire.

Args:

projectId: The project ID
campfireId: The Campfire ID
format: Response format

Returns: Paginated list of chat lines/messages.

{
  "type": "object",
  "required": [
    "projectId",
    "campfireId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "campfireId": {
      "type": "number",
      "description": "Campfire ID"
    }
  }
}

basecamp_get_campfire_line

Get a single Campfire chat message.

Args:

projectId: The project ID
lineId: The line/message ID
format: Response format

Returns: The chat message with content and creator.

{
  "type": "object",
  "required": [
    "projectId",
    "lineId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "lineId": {
      "type": "number",
      "description": "Line ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_campfire_line

Post a new message to a Campfire.

Args:

projectId: The project ID
campfireId: The Campfire ID
content: The message content (plain text)

Returns: The created chat message.

{
  "type": "object",
  "required": [
    "projectId",
    "campfireId",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "Message content"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "campfireId": {
      "type": "number",
      "description": "Campfire ID"
    }
  }
}

basecamp_delete_campfire_line

Delete a Campfire chat message.

Args:

projectId: The project ID
lineId: The line/message ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "projectId",
    "lineId"
  ],
  "properties": {
    "lineId": {
      "type": "number",
      "description": "Line ID to delete"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_card_table

Get a card table (Kanban board).

Get the card table ID from the project's dock items.

Args:

projectId: The project ID
cardTableId: The card table ID
format: Response format

Returns: The card table with all columns and their card counts.

{
  "type": "object",
  "required": [
    "projectId",
    "cardTableId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "cardTableId": {
      "type": "number",
      "description": "Card table ID"
    }
  }
}

basecamp_list_cards

List all cards in a card table column.

Args:

projectId: The project ID
columnId: The column ID
format: Response format

Returns: Paginated list of cards in the column.

{
  "type": "object",
  "required": [
    "projectId",
    "columnId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "columnId": {
      "type": "number",
      "description": "Column ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_card

Get a single card.

Args:

projectId: The project ID
cardId: The card ID
format: Response format

Returns: The card with title, content, assignees, and due date.

{
  "type": "object",
  "required": [
    "projectId",
    "cardId"
  ],
  "properties": {
    "cardId": {
      "type": "number",
      "description": "Card ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_list_comments

List all comments on a recording (message, todo, document, etc.).

Args:

projectId: The project ID
recordingId: The recording ID (message, todo, document, etc.)
format: Response format

Returns: Paginated list of comments.

{
  "type": "object",
  "required": [
    "projectId",
    "recordingId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "recordingId": {
      "type": "number",
      "description": "Recording ID"
    }
  }
}

basecamp_get_comment

Get a single comment.

Args:

projectId: The project ID
commentId: The comment ID
format: Response format

Returns: The comment with content and creator.

{
  "type": "object",
  "required": [
    "projectId",
    "commentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "commentId": {
      "type": "number",
      "description": "Comment ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_comment

Add a comment to a recording (message, todo, document, etc.).

Args:

projectId: The project ID
recordingId: The recording ID to comment on
content: HTML content of the comment

Returns: The created comment.

{
  "type": "object",
  "required": [
    "projectId",
    "recordingId",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "HTML content"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "recordingId": {
      "type": "number",
      "description": "Recording ID"
    }
  }
}

basecamp_update_comment

Update an existing comment.

Args:

projectId: The project ID
commentId: The comment ID
content: New HTML content

Returns: The updated comment.

{
  "type": "object",
  "required": [
    "projectId",
    "commentId",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "New HTML content"
    },
    "commentId": {
      "type": "number",
      "description": "Comment ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_vault

Get a vault (folder) for documents and files.

The vault is the container for all documents and uploads in a project. Get the root vault ID from the project's dock items.

Args:

projectId: The project ID
vaultId: The vault ID
format: Response format

Returns: The vault with document/upload counts and nested vault links.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "vaultId": {
      "type": "number",
      "description": "Vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_list_vaults

List nested vaults (subfolders) within a vault.

Args:

projectId: The project ID
vaultId: The parent vault ID
format: Response format

Returns: Paginated list of nested vaults.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "vaultId": {
      "type": "number",
      "description": "Parent vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_vault

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

Args:

projectId: The project ID
vaultId: The parent vault ID
title: Vault/folder name (required)

Returns: The created vault.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Vault name"
    },
    "vaultId": {
      "type": "number",
      "description": "Parent vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_update_vault

Update a vault's title.

Args:

projectId: The project ID
vaultId: The vault ID
title: New vault name (required)

Returns: The updated vault.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New vault name"
    },
    "vaultId": {
      "type": "number",
      "description": "Vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_list_documents

List all documents in a vault.

Args:

projectId: The project ID
vaultId: The vault ID
status: Filter by status ('active', 'archived', 'trashed')
format: Response format

Returns: Paginated list of documents.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "vaultId": {
      "type": "number",
      "description": "Vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_document

Get a single document.

Args:

projectId: The project ID
documentId: The document ID
format: Response format

Returns: The document with title and content.

{
  "type": "object",
  "required": [
    "projectId",
    "documentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "documentId": {
      "type": "number",
      "description": "Document ID"
    }
  }
}

basecamp_create_document

Create a new document in a vault.

Args:

projectId: The project ID
vaultId: The vault ID
title: Document title (required)
content: HTML content (required)
status: 'active' to publish, 'draft' to save as draft

Returns: The created document.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId",
    "title",
    "content"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Document title"
    },
    "status": {
      "enum": [
        "active",
        "draft"
      ],
      "type": "string",
      "default": "active",
      "description": "Publish status"
    },
    "content": {
      "type": "string",
      "description": "HTML content"
    },
    "vaultId": {
      "type": "number",
      "description": "Vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_update_document

Update an existing document.

Args:

projectId: The project ID
documentId: The document ID
title: New document title
content: New HTML content

Returns: The updated document.

{
  "type": "object",
  "required": [
    "projectId",
    "documentId"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New document title"
    },
    "content": {
      "type": "string",
      "description": "New HTML content"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "documentId": {
      "type": "number",
      "description": "Document ID"
    }
  }
}

basecamp_list_uploads

List all file uploads in a vault.

Args:

projectId: The project ID
vaultId: The vault ID
status: Filter by status ('active', 'archived', 'trashed')
format: Response format

Returns: Paginated list of uploads with download URLs.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "vaultId": {
      "type": "number",
      "description": "Vault ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_upload

Get a single file upload.

Args:

projectId: The project ID
uploadId: The upload ID
format: Response format

Returns: The upload with filename, size, and download URL.

{
  "type": "object",
  "required": [
    "projectId",
    "uploadId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "uploadId": {
      "type": "number",
      "description": "Upload ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_upload

Create a new file upload in a vault.

Note: First use basecamp_create_attachment to upload the file and get an attachable_sgid, then use this tool to add it to a vault.

Args:

projectId: The project ID
vaultId: The vault ID
attachableSgid: The attachment SGID from basecamp_create_attachment
description: HTML description
baseName: Custom filename (without extension)

Returns: The created upload.

{
  "type": "object",
  "required": [
    "projectId",
    "vaultId",
    "attachableSgid"
  ],
  "properties": {
    "vaultId": {
      "type": "number",
      "description": "Vault ID"
    },
    "baseName": {
      "type": "string",
      "description": "Custom filename"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "description": {
      "type": "string",
      "description": "HTML description"
    },
    "attachableSgid": {
      "type": "string",
      "description": "Attachment SGID"
    }
  }
}

basecamp_update_upload

Update an existing upload's description or filename.

Args:

projectId: The project ID
uploadId: The upload ID
description: New HTML description
baseName: New filename (without extension)

Returns: The updated upload.

{
  "type": "object",
  "required": [
    "projectId",
    "uploadId"
  ],
  "properties": {
    "baseName": {
      "type": "string",
      "description": "New filename"
    },
    "uploadId": {
      "type": "number",
      "description": "Upload ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "description": {
      "type": "string",
      "description": "New HTML description"
    }
  }
}

basecamp_list_webhooks

List all webhooks for a project.

Args:

projectId: The project ID
format: Response format

Returns: Paginated list of webhooks.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_message_board

Get the message board for a project.

The message board is the container for all messages in a project. Get the message board ID from the project's dock items.

Args:

projectId: The project ID
messageBoardId: The message board ID
format: Response format

Returns: The message board with message count and messages URL.

{
  "type": "object",
  "required": [
    "projectId",
    "messageBoardId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "messageBoardId": {
      "type": "number",
      "description": "Message board ID"
    }
  }
}

basecamp_list_messages

List all messages in a message board.

Args:

projectId: The project ID
messageBoardId: The message board ID
status: Filter by status ('active', 'archived', 'trashed')
format: Response format

Returns: Paginated list of messages.

{
  "type": "object",
  "required": [
    "projectId",
    "messageBoardId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "messageBoardId": {
      "type": "number",
      "description": "Message board ID"
    }
  }
}

basecamp_get_message

Get a single message.

Args:

projectId: The project ID
messageId: The message ID
format: Response format

Returns: The message with subject, content, and creator.

{
  "type": "object",
  "required": [
    "projectId",
    "messageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "messageId": {
      "type": "number",
      "description": "Message ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_message

Create a new message on a message board.

Args:

projectId: The project ID
messageBoardId: The message board ID
subject: Message subject (required)
content: HTML content
status: 'active' to publish immediately, 'draft' to save as draft
categoryId: Message type/category ID

Returns: The created message.

{
  "type": "object",
  "required": [
    "projectId",
    "messageBoardId",
    "subject"
  ],
  "properties": {
    "status": {
      "enum": [
        "active",
        "draft"
      ],
      "type": "string",
      "default": "active",
      "description": "Publish status"
    },
    "content": {
      "type": "string",
      "description": "HTML content"
    },
    "subject": {
      "type": "string",
      "description": "Message subject"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "categoryId": {
      "type": "number",
      "description": "Message category ID"
    },
    "messageBoardId": {
      "type": "number",
      "description": "Message board ID"
    }
  }
}

basecamp_update_message

Update an existing message.

Args:

projectId: The project ID
messageId: The message ID
subject: New subject
content: New HTML content
categoryId: New category ID

Returns: The updated message.

{
  "type": "object",
  "required": [
    "projectId",
    "messageId"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "New HTML content"
    },
    "subject": {
      "type": "string",
      "description": "New subject"
    },
    "messageId": {
      "type": "number",
      "description": "Message ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "categoryId": {
      "type": "number",
      "description": "New category ID"
    }
  }
}

basecamp_test_connection

Test the connection to Basecamp API.

Verifies that the OAuth token and account ID are valid.

Returns: Connection status and current user info.

{
  "type": "object",
  "properties": {}
}

basecamp_get_my_profile

Get the current user's profile.

Returns: The authenticated user's profile information.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

basecamp_list_people

List all people visible to the current user.

Returns: Paginated list of all people in the account.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

basecamp_list_project_people

List all people assigned to a project.

Args:

projectId: The project ID
format: Response format

Returns: Paginated list of people in the project.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_person

Get a person by ID.

Args:

personId: The person ID
format: Response format

Returns: The person's profile information.

{
  "type": "object",
  "required": [
    "personId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "personId": {
      "type": "number",
      "description": "Person ID"
    }
  }
}

basecamp_list_projects

List all Basecamp projects.

Returns a paginated list of projects visible to the current user.

Args:

status: Filter by status ('active', 'archived', 'trashed'). Default: 'active'
format: Response format ('json' or 'markdown')

Returns: List of projects with their names, descriptions, and dock items.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

basecamp_get_project

Get a single Basecamp project by ID.

Args:

projectId: The project ID
format: Response format ('json' or 'markdown')

Returns: The project with its dock items (message board, todoset, schedule, vault, etc.)

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_project

Create a new Basecamp project.

Args:

name: Project name (required)
description: Project description

Returns: The created project.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Project name"
    },
    "description": {
      "type": "string",
      "description": "Project description"
    }
  }
}

basecamp_update_project

Update an existing Basecamp project.

Args:

projectId: Project ID to update
name: New project name
description: New project description

Returns: The updated project.

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New project name"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID to update"
    },
    "description": {
      "type": "string",
      "description": "New project description"
    }
  }
}

basecamp_list_recordings

List recordings across projects.

Recordings represent all content types in Basecamp. Use this to find items across multiple projects or to list archived/trashed items.

Args:

type: Recording type (required). One of: Comment, Document, Message, Todo, Todolist, Upload, Vault, Schedule::Entry, Question::Answer, Kanban::Card, Kanban::Step
bucketIds: Array of project IDs to filter by
status: Filter by status ('active', 'archived', 'trashed'). Default: 'active'
sort: Sort by 'created_at' or 'updated_at'. Default: 'created_at'
direction: Sort direction ('asc' or 'desc'). Default: 'desc'
format: Response format

Returns: Paginated list of recordings.

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "sort": {
      "enum": [
        "created_at",
        "updated_at"
      ],
      "type": "string",
      "default": "created_at",
      "description": "Sort field"
    },
    "type": {
      "type": "string",
      "description": "Recording type (e.g., Todo, Message, Document)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "default": "active",
      "description": "Filter by status"
    },
    "bucketIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Project IDs to filter by"
    },
    "direction": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction"
    }
  }
}

basecamp_trash_recording

Move a recording to trash.

Use this to delete any content type (message, todo, document, etc.).

Args:

projectId: The project ID
recordingId: The recording ID to trash

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "projectId",
    "recordingId"
  ],
  "properties": {
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "recordingId": {
      "type": "number",
      "description": "Recording ID to trash"
    }
  }
}

basecamp_archive_recording

Archive a recording.

Use this to archive any content type (message, todo, document, etc.).

Args:

projectId: The project ID
recordingId: The recording ID to archive

Returns: Confirmation of archival.

{
  "type": "object",
  "required": [
    "projectId",
    "recordingId"
  ],
  "properties": {
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "recordingId": {
      "type": "number",
      "description": "Recording ID to archive"
    }
  }
}

basecamp_unarchive_recording

Restore an archived recording to active status.

Args:

projectId: The project ID
recordingId: The recording ID to unarchive

Returns: Confirmation of restoration.

{
  "type": "object",
  "required": [
    "projectId",
    "recordingId"
  ],
  "properties": {
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "recordingId": {
      "type": "number",
      "description": "Recording ID to unarchive"
    }
  }
}

basecamp_get_schedule

Get the schedule for a project.

The schedule is the container for all calendar events. Get the schedule ID from the project's dock items.

Args:

projectId: The project ID
scheduleId: The schedule ID
format: Response format

Returns: The schedule with entry count and entries URL.

{
  "type": "object",
  "required": [
    "projectId",
    "scheduleId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "scheduleId": {
      "type": "number",
      "description": "Schedule ID"
    }
  }
}

basecamp_list_schedule_entries

List all schedule entries (events) in a schedule.

Args:

projectId: The project ID
scheduleId: The schedule ID
status: Filter by status ('active', 'archived', 'trashed')
format: Response format

Returns: Paginated list of schedule entries.

{
  "type": "object",
  "required": [
    "projectId",
    "scheduleId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "scheduleId": {
      "type": "number",
      "description": "Schedule ID"
    }
  }
}

basecamp_get_schedule_entry

Get a single schedule entry (event).

Args:

projectId: The project ID
entryId: The schedule entry ID
format: Response format

Returns: The schedule entry with dates, participants, and description.

{
  "type": "object",
  "required": [
    "projectId",
    "entryId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "entryId": {
      "type": "number",
      "description": "Schedule entry ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_schedule_entry

Create a new schedule entry (event).

Args:

projectId: The project ID
scheduleId: The schedule ID
summary: Event title (required)
startsAt: Start date/time in ISO 8601 format (required)
endsAt: End date/time in ISO 8601 format (required)
description: HTML description
participantIds: Array of person IDs to invite
allDay: Whether this is an all-day event
notify: Whether to notify participants

Returns: The created schedule entry.

{
  "type": "object",
  "required": [
    "projectId",
    "scheduleId",
    "summary",
    "startsAt",
    "endsAt"
  ],
  "properties": {
    "allDay": {
      "type": "boolean",
      "description": "All-day event"
    },
    "endsAt": {
      "type": "string",
      "description": "End date/time (ISO 8601)"
    },
    "notify": {
      "type": "boolean",
      "description": "Notify participants"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "startsAt": {
      "type": "string",
      "description": "Start date/time (ISO 8601)"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "scheduleId": {
      "type": "number",
      "description": "Schedule ID"
    },
    "description": {
      "type": "string",
      "description": "HTML description"
    },
    "participantIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Person IDs to invite"
    }
  }
}

basecamp_update_todo

Update an existing to-do.

Args:

projectId: The project ID
todoId: The to-do ID
content: New to-do content/title
description: New HTML description
assigneeIds: New array of person IDs to assign
dueOn: New due date (YYYY-MM-DD format)
startsOn: New start date (YYYY-MM-DD format)

Returns: The updated to-do.

{
  "type": "object",
  "required": [
    "projectId",
    "todoId"
  ],
  "properties": {
    "dueOn": {
      "type": "string",
      "description": "Due date (YYYY-MM-DD)"
    },
    "todoId": {
      "type": "number",
      "description": "Todo ID"
    },
    "content": {
      "type": "string",
      "description": "Todo content/title"
    },
    "startsOn": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "assigneeIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Person IDs to assign"
    },
    "description": {
      "type": "string",
      "description": "HTML description"
    }
  }
}

basecamp_update_schedule_entry

Update an existing schedule entry (event).

Args:

projectId: The project ID
entryId: The schedule entry ID
summary: New event title
startsAt: New start date/time (ISO 8601)
endsAt: New end date/time (ISO 8601)
description: New HTML description
participantIds: New array of person IDs
allDay: Whether this is an all-day event
notify: Whether to notify participants

Returns: The updated schedule entry.

{
  "type": "object",
  "required": [
    "projectId",
    "entryId"
  ],
  "properties": {
    "allDay": {
      "type": "boolean",
      "description": "All-day event"
    },
    "endsAt": {
      "type": "string",
      "description": "New end date/time (ISO 8601)"
    },
    "notify": {
      "type": "boolean",
      "description": "Notify participants"
    },
    "entryId": {
      "type": "number",
      "description": "Schedule entry ID"
    },
    "summary": {
      "type": "string",
      "description": "New event title"
    },
    "startsAt": {
      "type": "string",
      "description": "New start date/time (ISO 8601)"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "description": {
      "type": "string",
      "description": "New HTML description"
    },
    "participantIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "New person IDs"
    }
  }
}

basecamp_get_todoset

Get a to-do set for a project.

The todoset is the container for all to-do lists in a project. Get the todoset ID from the project's dock items.

Args:

projectId: The project ID (bucket ID)
todosetId: The todoset ID

Returns: The todoset with completion stats and link to todolists.

{
  "type": "object",
  "required": [
    "projectId",
    "todosetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todosetId": {
      "type": "number",
      "description": "Todoset ID"
    }
  }
}

basecamp_list_todolists

List all to-do lists in a todoset.

Args:

projectId: The project ID
todosetId: The todoset ID
status: Filter by status ('active', 'archived', 'trashed')
format: Response format

Returns: Paginated list of to-do lists.

{
  "type": "object",
  "required": [
    "projectId",
    "todosetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todosetId": {
      "type": "number",
      "description": "Todoset ID"
    }
  }
}

basecamp_get_todolist

Get a single to-do list.

Args:

projectId: The project ID
todolistId: The to-do list ID
format: Response format

Returns: The to-do list with completion stats.

{
  "type": "object",
  "required": [
    "projectId",
    "todolistId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todolistId": {
      "type": "number",
      "description": "Todolist ID"
    }
  }
}

basecamp_create_todolist

Create a new to-do list in a todoset.

Args:

projectId: The project ID
todosetId: The todoset ID
name: Name of the to-do list (required)
description: HTML description

Returns: The created to-do list.

{
  "type": "object",
  "required": [
    "projectId",
    "todosetId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Todolist name"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todosetId": {
      "type": "number",
      "description": "Todoset ID"
    },
    "description": {
      "type": "string",
      "description": "HTML description"
    }
  }
}

basecamp_update_todolist

Update an existing to-do list.

Args:

projectId: The project ID
todolistId: The to-do list ID
name: New name (required)
description: New HTML description

Returns: The updated to-do list.

{
  "type": "object",
  "required": [
    "projectId",
    "todolistId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Todolist name"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todolistId": {
      "type": "number",
      "description": "Todolist ID"
    },
    "description": {
      "type": "string",
      "description": "HTML description"
    }
  }
}

basecamp_list_todos

List all to-dos in a to-do list.

Args:

projectId: The project ID
todolistId: The to-do list ID
status: Filter by status ('active', 'archived', 'trashed')
completed: Filter by completion (true = completed only, false = pending only)
format: Response format

Returns: Paginated list of to-dos.

{
  "type": "object",
  "required": [
    "projectId",
    "todolistId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "trashed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "completed": {
      "type": "boolean",
      "description": "Filter by completion status"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todolistId": {
      "type": "number",
      "description": "Todolist ID"
    }
  }
}

basecamp_get_todo

Get a single to-do.

Args:

projectId: The project ID
todoId: The to-do ID
format: Response format

Returns: The to-do with assignees, due date, and description.

{
  "type": "object",
  "required": [
    "projectId",
    "todoId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "todoId": {
      "type": "number",
      "description": "Todo ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_create_todo

Create a new to-do in a to-do list.

Args:

projectId: The project ID
todolistId: The to-do list ID
content: The to-do content/title (required)
description: HTML description
assigneeIds: Array of person IDs to assign
dueOn: Due date (YYYY-MM-DD format)
startsOn: Start date (YYYY-MM-DD format)
notify: Whether to notify assignees

Returns: The created to-do.

{
  "type": "object",
  "required": [
    "projectId",
    "todolistId",
    "content"
  ],
  "properties": {
    "dueOn": {
      "type": "string",
      "description": "Due date (YYYY-MM-DD)"
    },
    "notify": {
      "type": "boolean",
      "description": "Notify assignees"
    },
    "content": {
      "type": "string",
      "description": "Todo content/title"
    },
    "startsOn": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "todolistId": {
      "type": "number",
      "description": "Todolist ID"
    },
    "assigneeIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Person IDs to assign"
    },
    "description": {
      "type": "string",
      "description": "HTML description"
    }
  }
}

basecamp_complete_todo

Mark a to-do as complete.

Args:

projectId: The project ID
todoId: The to-do ID

Returns: Confirmation of completion.

{
  "type": "object",
  "required": [
    "projectId",
    "todoId"
  ],
  "properties": {
    "todoId": {
      "type": "number",
      "description": "Todo ID"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    }
  }
}

basecamp_get_webhook

Get a single webhook with delivery history.

Args:

projectId: The project ID
webhookId: The webhook ID
format: Response format

Returns: The webhook with its configuration.

{
  "type": "object",
  "required": [
    "projectId",
    "webhookId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "webhookId": {
      "type": "number",
      "description": "Webhook ID"
    }
  }
}

basecamp_create_webhook

Create a new webhook for a project.

Args:

projectId: The project ID
payloadUrl: HTTPS URL to receive webhook payloads (required)
types: Array of event types to subscribe to, or ['all'] for all events

Supported event types: Comment, Document, Message, Todo, Todolist, Upload, Vault, Schedule::Entry, Question, Question::Answer, Kanban::Card, Kanban::Step, CloudFile, GoogleDocument, Client::Approval::Response, Client::Forward, Client::Reply, Inbox::Forward

Returns: The created webhook.

{
  "type": "object",
  "required": [
    "projectId",
    "payloadUrl",
    "types"
  ],
  "properties": {
    "types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event types to subscribe to"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "payloadUrl": {
      "type": "string",
      "description": "HTTPS payload URL"
    }
  }
}

basecamp_update_webhook

Update an existing webhook.

Args:

projectId: The project ID
webhookId: The webhook ID
payloadUrl: New HTTPS payload URL
types: New array of event types
active: Enable/disable the webhook

Returns: The updated webhook.

{
  "type": "object",
  "required": [
    "projectId",
    "webhookId"
  ],
  "properties": {
    "types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New event types"
    },
    "active": {
      "type": "boolean",
      "description": "Enable/disable webhook"
    },
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "webhookId": {
      "type": "number",
      "description": "Webhook ID"
    },
    "payloadUrl": {
      "type": "string",
      "description": "New HTTPS payload URL"
    }
  }
}

basecamp_delete_webhook

Delete a webhook.

Args:

projectId: The project ID
webhookId: The webhook ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "projectId",
    "webhookId"
  ],
  "properties": {
    "projectId": {
      "type": "number",
      "description": "Project ID"
    },
    "webhookId": {
      "type": "number",
      "description": "Webhook ID"
    }
  }
}