Calendar
Tools for calendar sharing and the colours assigned to activity types.
This page covers 4 tools, all of them available on request rather than in the default tool list.
- Status — In the default tool list means the tool is one of the ~200 Aprimo advertises to every agent out of the box, so the agent discovers and calls it on its own. Available on request means the tool is registered and fully callable, but sits outside that default list — call it by name, or ask Aprimo to extend the list your tenant is served.
- Both statuses work identically when called. Status affects discovery, not capability or authorization.
- Visibility is not authorization. Every tool call executes as the authenticated user, and any tool can return an authorization error if that user lacks rights to the record, task, or file. See the MCP Tool Permission Map.
- Destructive tools are labelled as such. They delete or irreversibly overwrite data, and will not act unless the call sets both
confirmedandconfirmedDestructivetotrue. - Activity and Project labels vary by tenant. Where this page says Activity or Project, your tenant's own configured terminology is substituted at runtime.
Aprimo's MCP Server exposes far more tools than most MCP clients handle well — many degrade or truncate their tool list well below the full catalogue. Rather than let a client truncate arbitrarily, Aprimo advertises a curated set of roughly 200 tools covering the tasks customers most commonly automate. Everything outside that set remains fully supported and callable by name; it simply isn't offered up front. If your integration leans on a tool that is available on request, talk to your Aprimo Customer Success Manager about extending the advertised list for your tenant.
Tools at a Glance
| Tool | Status | What it does |
|---|---|---|
get_calendar_activity_type_colors | On request | Retrieves the configured display colors for each calendar activity type in Aprimo Marketing Operations. |
get_shared_calendar_access | On request | Returns the list of users a calendar is shared with and their access rights in Aprimo Marketing Operations. |
share_calendar | On request | Shares a calendar with a list of users and grants their access rights in Aprimo Marketing Operations. |
update_calendar_activity_type_colors | On request | Updates the display colors assigned to calendar activity types in Aprimo Marketing Operations. |
get_calendar_activity_type_colors
Available on request
Retrieves the configured display colors for each calendar activity type in Aprimo Marketing Operations.
Response format: the response carries pre-rendered markdown blocks intended to be displayed verbatim.
Parameters: none.
Returns:
| Field | Type | Description |
|---|---|---|
count | integer | |
items | array of CalendarActivityTypeColorProjection | |
items[].raw | object (optional) |
get_shared_calendar_access
Available on request
Returns the list of users a calendar is shared with and their access rights in Aprimo Marketing Operations.
Response format: the response carries pre-rendered markdown blocks intended to be displayed verbatim.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
calendarId | string | Yes | The calendar's integer ID. |
Returns:
| Field | Type | Description |
|---|---|---|
count | integer | |
items | array of CalendarAccessEntryProjection | |
items[].objectId | integer | |
items[].userId | integer | |
items[].userName | string (optional) | |
items[].hasEditRight | integer | |
items[].avatarUrl | string (optional) |
share_calendar
Available on request
Shares a calendar with a list of users and grants their access rights in Aprimo Marketing Operations. Requires confirmed=true after showing the user the exact payload. Returns the resulting access list.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
calendarId | string | Yes | The calendar's integer ID to share. |
body | string | Yes | JSON object with the calendar identifier and the access list entries to apply (PM wire names). |
confirmed | boolean | No | Must be true to proceed. Omit (or false) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly approved the payload. |
Returns:
| Field | Type | Description |
|---|---|---|
count | integer | |
items | array of CalendarAccessEntryProjection | |
items[].objectId | integer | |
items[].userId | integer | |
items[].userName | string (optional) | |
items[].hasEditRight | integer | |
items[].avatarUrl | string (optional) |
update_calendar_activity_type_colors
Available on request
Updates the display colors assigned to calendar activity types in Aprimo Marketing Operations. Requires confirmed=true after showing the user the exact payload. Returns the resulting colors.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
body | string | Yes | JSON object with the activity type color assignments to apply (PM wire names). |
confirmed | boolean | No | Must be true to proceed. Omit (or false) to get a confirmation gate error, then call again with confirmed=true after the user has explicitly approved the payload. |
Returns:
| Field | Type | Description |
|---|---|---|
count | integer | |
items | array of CalendarActivityTypeColorProjection | |
items[].raw | object (optional) |
Related
- Aprimo MCP Server — configuration, connection details, and authentication
- MCP Tool Permission Map — the Aprimo permissions that make each tool visible to your agent
- REST API vs. MCP — choosing the right integration approach for your agent