CompanyCam
CompanyCam is a photo documentation platform for the trades. Projects, photos, comments, tags, checklists, and documents live in the account; this integration covers the full project lifecycle, photo upload with deduplication, comments and tags, and checklist management.
Available Tools
Projects
| Tool |
Purpose |
Approval |
companycam_search_projects |
Search projects by name or address |
Auto |
companycam_get_project |
Fetch full details for one project |
Auto |
companycam_list_documents |
List contracts, specs, and files on a project |
Auto |
companycam_create_project |
Create a new project |
Ask |
companycam_update_project |
Rename a project or update its address |
Ask |
companycam_update_notepad |
Add or update project notes |
Ask |
companycam_archive_project |
Archive a completed project |
Ask |
companycam_delete_project |
Permanently delete a project (cannot be undone) |
Ask |
Photos and Comments
| Tool |
Purpose |
Approval |
companycam_search_photos |
Search photos by project or date range |
Auto |
companycam_list_comments |
List comments on a project or photo |
Auto |
companycam_upload_photo |
Upload a photo to a project |
Ask |
companycam_add_comment |
Add a comment to a project or photo |
Ask |
companycam_tag_photo |
Add tags to a photo |
Ask |
companycam_delete_photo |
Permanently delete a photo (cannot be undone) |
Ask |
Checklists
| Tool |
Purpose |
Approval |
companycam_list_checklists |
List checklists on a project |
Auto |
companycam_get_checklist |
View full checklist with task completion |
Auto |
companycam_create_checklist |
Create a checklist on a project from a template |
Ask |
Entity vocabulary
- Project: a job site or property. Has
id, name, address, status, notepad, primary contact. Photos, documents, checklists, and comments hang off the project.
- Photo: an uploaded image. Has
id, optional description, tags, and a CompanyCam-side processing_status (pending, processing, processed, duplicate, processing_error).
- Checklist: a task list bound to a project, instantiated from a template. Sections contain tasks; each task carries a
completed_at timestamp when done.
Finding a project
A project you have not searched this session is unknown, not absent. Never tell the user a project does not exist, and never offer companycam_create_project, until companycam_search_projects has returned no match for the name they gave. Search the bare name first; adding a guessed token (an address you are not sure of) can narrow a name match to zero. A project ID you already resolved this session can be reused without re-searching.
Photo handles
See the analyze_photo tool description for the media_XXXXXX handle convention.
CompanyCam may report two non-success outcomes:
duplicate: the same image bytes (MD5) already exist on the project. Surface this so the user knows a re-send was a no-op.
processing_error: CompanyCam could not fetch the temporary URL. The upload is not recorded; a fresh retry on the same handle will try again.
Dates
companycam_search_photos takes ISO 8601 dates for start_date and end_date (2026-05-11 or 2026-05-11T08:00:00). End-of-day is applied automatically to end_date.
Tags
Derive tags from the conversation context. Common dimensions:
- Room or area:
kitchen, bathroom, exterior, roof
- Work type:
demo, framing, finish, inspection
- Stage:
before, during, after
Tags are trimmed at 50 chars and capped at 10 per call.
Common Workflows
Upload a photo with job context
companycam_search_projects(query="<address or client>"). Required even when the user names a project you do not recognize: see "Finding a project".
- If the search returns no match,
companycam_create_project(name="<Client - Address>", address="<address>").
companycam_upload_photo(project_id="...", original_url="media_XXXXXX", tags=[...], description="..."). One call per photo, one handle per call.
- Summarize what you assumed (project, tags) in one line so the user can amend.
Document progress on existing photos
- After upload, if the user adds context ("this is the finished kitchen"), use
companycam_tag_photo or companycam_add_comment(target_type="photo", target_id="...", content="...").
- Use project-level comments (
target_type="project") for site-wide notes, not photo-specific observations.
Project handoff or close-out
companycam_get_project(project_id="...") to confirm address, contact, status.
companycam_list_documents(project_id="...") for attached contracts or specs.
companycam_archive_project(project_id="...") when the job is complete. Use companycam_delete_project only on explicit request.
Work a checklist
companycam_list_checklists(project_id="...") to see what exists.
companycam_get_checklist(project_id="...", checklist_id="...") for task-by-task progress.
companycam_create_checklist requires a template_id; ask the user which template to use rather than guessing.
Find recent work across projects
companycam_search_photos(start_date="2026-05-01", end_date="2026-05-15") browses recent photos across all projects. Constrain to one project with project_id.
Companion integrations
- ServiceTitan: CompanyCam projects for an ST job are keyed by the customer's address. Resolve the address via
st_get_customer before companycam_search_projects. ServiceTitan customer ids are not CompanyCam project ids.
- QuickBooks: cross-link customers by name plus address; the IDs are not interchangeable. Reference uploaded photos in invoice or estimate notes by their CompanyCam URL.
- AppFolio Vendor: both tools accept
media_XXXXXX handles directly. A photo already staged for one can be attached to the other in the same conversation without re-sending.
Connecting
CompanyCam uses OAuth 2.0 authorization code flow. Use manage_integration(action='connect', target='companycam') to start the flow; the user is redirected to CompanyCam to grant access. Until that runs, the tools stay surfaced under "Not connected" in list_capabilities and refuse to execute.
1---2name: companycam3description: CompanyCam4---5# CompanyCam67CompanyCam is a photo documentation platform for the trades. Projects, photos, comments, tags, checklists, and documents live in the account; this integration covers the full project lifecycle, photo upload with deduplication, comments and tags, and checklist management.89## Available Tools1011### Projects12| Tool | Purpose | Approval |13|------|---------|----------|14| `companycam_search_projects` | Search projects by name or address | Auto |15| `companycam_get_project` | Fetch full details for one project | Auto |16| `companycam_list_documents` | List contracts, specs, and files on a project | Auto |17| `companycam_create_project` | Create a new project | Ask |18| `companycam_update_project` | Rename a project or update its address | Ask |19| `companycam_update_notepad` | Add or update project notes | Ask |20| `companycam_archive_project` | Archive a completed project | Ask |21| `companycam_delete_project` | Permanently delete a project (cannot be undone) | Ask |2223### Photos and Comments24| Tool | Purpose | Approval |25|------|---------|----------|26| `companycam_search_photos` | Search photos by project or date range | Auto |27| `companycam_list_comments` | List comments on a project or photo | Auto |28| `companycam_upload_photo` | Upload a photo to a project | Ask |29| `companycam_add_comment` | Add a comment to a project or photo | Ask |30| `companycam_tag_photo` | Add tags to a photo | Ask |31| `companycam_delete_photo` | Permanently delete a photo (cannot be undone) | Ask |3233### Checklists34| Tool | Purpose | Approval |35|------|---------|----------|36| `companycam_list_checklists` | List checklists on a project | Auto |37| `companycam_get_checklist` | View full checklist with task completion | Auto |38| `companycam_create_checklist` | Create a checklist on a project from a template | Ask |3940## Entity vocabulary4142- **Project**: a job site or property. Has `id`, `name`, `address`, `status`, `notepad`, primary contact. Photos, documents, checklists, and comments hang off the project.43- **Photo**: an uploaded image. Has `id`, optional `description`, tags, and a CompanyCam-side `processing_status` (`pending`, `processing`, `processed`, `duplicate`, `processing_error`).44- **Checklist**: a task list bound to a project, instantiated from a template. Sections contain tasks; each task carries a `completed_at` timestamp when done.4546## Finding a project4748A project you have not searched this session is unknown, not absent. Never tell the user a project does not exist, and never offer `companycam_create_project`, until `companycam_search_projects` has returned no match for the name they gave. Search the bare name first; adding a guessed token (an address you are not sure of) can narrow a name match to zero. A project ID you already resolved this session can be reused without re-searching.4950## Photo handles5152See the ``analyze_photo`` tool description for the ``media_XXXXXX`` handle convention.5354CompanyCam may report two non-success outcomes:55- `duplicate`: the same image bytes (MD5) already exist on the project. Surface this so the user knows a re-send was a no-op.56- `processing_error`: CompanyCam could not fetch the temporary URL. The upload is not recorded; a fresh retry on the same handle will try again.5758## Dates5960`companycam_search_photos` takes ISO 8601 dates for `start_date` and `end_date` (`2026-05-11` or `2026-05-11T08:00:00`). End-of-day is applied automatically to `end_date`.6162## Tags6364Derive tags from the conversation context. Common dimensions:65- Room or area: `kitchen`, `bathroom`, `exterior`, `roof`66- Work type: `demo`, `framing`, `finish`, `inspection`67- Stage: `before`, `during`, `after`6869Tags are trimmed at 50 chars and capped at 10 per call.7071## Common Workflows7273### Upload a photo with job context741. `companycam_search_projects(query="<address or client>")`. Required even when the user names a project you do not recognize: see "Finding a project".752. If the search returns no match, `companycam_create_project(name="<Client - Address>", address="<address>")`.763. `companycam_upload_photo(project_id="...", original_url="media_XXXXXX", tags=[...], description="...")`. One call per photo, one handle per call.774. Summarize what you assumed (project, tags) in one line so the user can amend.7879### Document progress on existing photos801. After upload, if the user adds context ("this is the finished kitchen"), use `companycam_tag_photo` or `companycam_add_comment(target_type="photo", target_id="...", content="...")`.812. Use project-level comments (`target_type="project"`) for site-wide notes, not photo-specific observations.8283### Project handoff or close-out841. `companycam_get_project(project_id="...")` to confirm address, contact, status.852. `companycam_list_documents(project_id="...")` for attached contracts or specs.863. `companycam_archive_project(project_id="...")` when the job is complete. Use `companycam_delete_project` only on explicit request.8788### Work a checklist891. `companycam_list_checklists(project_id="...")` to see what exists.902. `companycam_get_checklist(project_id="...", checklist_id="...")` for task-by-task progress.913. `companycam_create_checklist` requires a `template_id`; ask the user which template to use rather than guessing.9293### Find recent work across projects94`companycam_search_photos(start_date="2026-05-01", end_date="2026-05-15")` browses recent photos across all projects. Constrain to one project with `project_id`.9596## Companion integrations9798- **ServiceTitan**: CompanyCam projects for an ST job are keyed by the customer's address. Resolve the address via `st_get_customer` before `companycam_search_projects`. ServiceTitan customer ids are not CompanyCam project ids.99- **QuickBooks**: cross-link customers by name plus address; the IDs are not interchangeable. Reference uploaded photos in invoice or estimate notes by their CompanyCam URL.100- **AppFolio Vendor**: both tools accept `media_XXXXXX` handles directly. A photo already staged for one can be attached to the other in the same conversation without re-sending.101102## Connecting103104CompanyCam uses OAuth 2.0 authorization code flow. Use `manage_integration(action='connect', target='companycam')` to start the flow; the user is redirected to CompanyCam to grant access. Until that runs, the tools stay surfaced under "Not connected" in `list_capabilities` and refuse to execute.