productivity
Basecamp 3 CLI for Shell Scripts
Use the Basecamp 3 CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Manual OAuth token auth
Basecamp 3 CLI for Shell Scripts
Call integration functions from shell scripts with stable JSON input and output.
Use shell scripts for small local automations that need one or more integration calls. The Basecamp 3 CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Basecamp 3 CLI for Shell Scripts
kosmokrator integrations:configure basecamp --set access_token="$BASECAMP_ACCESS_TOKEN" --set account_id="$BASECAMP_ACCOUNT_ID" --enable --read allow --write ask --json
kosmo integrations:call basecamp.basecamp_list_projects '{}' --json Discovery Before Execution
Agents and scripts can inspect Basecamp 3 docs and schemas before choosing a function.
kosmo integrations:docs basecamp --json
kosmo integrations:docs basecamp.basecamp_list_projects --json
kosmo integrations:schema basecamp.basecamp_list_projects --json
kosmo integrations:search "Basecamp 3" --json
kosmo integrations:list --json Useful Basecamp 3 CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
basecamp.basecamp_list_projects | Read | none | List all Basecamp projects visible to the authenticated user. Returns project names, IDs, descriptions, and creation dates. |
basecamp.basecamp_get_project | Read | project_id | Get details for a single Basecamp project by ID. Returns the project name, description, members, and metadata. |
basecamp.basecamp_list_todos | Read | project_id, todoset_id, todolist_id | List to-dos in a Basecamp to-do list. Requires the project ID, to-do set ID, and to-do list ID. Returns to-do items with their content, completion status, assignees, and due dates. |
basecamp.basecamp_create_todo | Write | project_id, todoset_id, todolist_id, content, description, due_on, assignee_ids | Create a new to-do in a Basecamp to-do list. Specify the project, to-do set, to-do list, and to-do text. Optionally include a description, due date, and assignee IDs. |
basecamp.basecamp_list_messages | Read | project_id | List messages (message board posts) for a Basecamp project. Returns message subjects, content excerpts, authors, and timestamps. |
basecamp.basecamp_get_message | Read | project_id, message_id | Get a single message from a Basecamp project by ID. Returns the full message subject, content, author, and metadata. |
basecamp.basecamp_get_current_user | Read | none | Get the profile of the currently authenticated Basecamp user. Returns name, email, avatar, and account details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.