Connectors

atlas_connectors_active_connection_test

Test the active connection of one connector by pinging the service with its stored credential, and record the outcome in the connector event log. Returns whether it succeeded, the latency, the granted scopes, the connected account and identity, and an error message on failure; no credential is returned. Works with a read-only token.

Scope

connectors:read

Calls

POST /integrations/{connectorId}/test

Example prompt

Check that our Google Drive connection still works.

Arguments

atlas_connectors_connections_revoke

Disconnect a specific stored connector connection through the admin-gated lifecycle route, revoking provider tokens best-effort and clearing local secrets.

Scope

connectors:manage

Calls

POST /v1/connectors/{connectorId}/disconnect

Example prompt

Disconnect Microsoft 365 connection conn_123.

Arguments

atlas_connectors_connections_test

Run an admin-gated smoke ping against a specific stored connector connection and record bounded health metadata without exposing credentials.

Scope

connectors:manage

Calls

POST /v1/connectors/{connectorId}/test

Example prompt

Test Linear connection conn_123.

Arguments

atlas_connectors_events_list

List recent tenant-scoped connector lifecycle events for a connector without exposing credentials or webhook payloads.

Scope

connectors:read

Calls

GET /integrations/{connectorId}/events

Example prompt

Show the last 25 Linear connector events.

Arguments

atlas_connectors_github_branches_list

List the branches of a GitHub repository. Returns one page of branches with the SHA each one points at and whether it is protected.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/branches

Example prompt

List the branches of atlas-org/web on GitHub.

Arguments

atlas_connectors_github_code_search

Search code in GitHub repositories with a GitHub code search query, such as a symbol name with repo:owner/name. Returns the total count and one page of matching files with their paths.

Scope

connectors:read

Calls

GET /v1/connectors/github/search/code

Example prompt

Where is parseToolName defined in atlas-org/web on GitHub?

Arguments

atlas_connectors_github_commits_get

Get one GitHub commit by SHA, branch or tag. Returns the commit message, author, parents, and the files it changed with their additions and deletions.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/commits/{ref}

Example prompt

Which files did commit 3f2a9c1 in atlas-org/web change?

Arguments

atlas_connectors_github_commits_list

List commits in a GitHub repository, optionally from a branch or SHA, for one file path, by one author or within a date range. Returns one page of commits, newest first.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/commits

Example prompt

Show the commits on main in atlas-org/web since Monday.

Arguments

atlas_connectors_github_contents_get

Read a file or list a directory in a GitHub repository at a path, optionally at a branch, tag or commit. Returns the file content, Base64 encoded, with its blob SHA, or the directory entries.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/contents

Example prompt

Read the README.md file from atlas-org/web on GitHub.

Arguments

atlas_connectors_github_contents_set

Create or replace one file in a GitHub repository by committing Base64 content with a commit message, optionally on a branch. Replacing a file needs its current blob SHA. Returns the new file and commit details.

Scope

connectors:manage

Calls

PUT /v1/connectors/github/repos/{owner}/{repo}/contents

Example prompt

Commit an updated CHANGELOG.md to the main branch of atlas-org/web.

Arguments

atlas_connectors_github_installations_disable

Disable a GitHub App installation for this workspace by its Atlas id, so Atlas stops acting on its events. The installation stays on GitHub; remove it there to uninstall. Returns no content on success.

Scope

connectors:manage

Calls

DELETE /v1/integrations/github/{id}

Example prompt

Disable the GitHub App installation for the old-org account.

Arguments

atlas_connectors_github_installations_list

List the GitHub App installations connected to this workspace. Returns each installation with its Atlas id, GitHub account login and type, who installed it and when, and whether it is disabled.

Scope

connectors:read

Calls

GET /v1/integrations/github

Example prompt

Which GitHub App installations are connected to this workspace?

Arguments

This tool takes no arguments.

atlas_connectors_github_issues_comments_create

Post a comment on a GitHub issue or pull request by its number, as the connected GitHub account. Returns the created comment, including its URL.

Scope

connectors:manage

Calls

POST /v1/connectors/github/repos/{owner}/{repo}/issues/{issueNumber}/comments

Example prompt

Comment on GitHub issue 42 that the fix is in review.

Arguments

atlas_connectors_github_issues_comments_list

List the comments on a GitHub issue or pull request by its number. Returns one page of comments in the order they were posted. Use it to read a discussion before replying.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/issues/{issueNumber}/comments

Example prompt

Show me the comments on GitHub issue 42 in atlas-org/web.

Arguments

atlas_connectors_github_issues_create

Open a new issue in a GitHub repository with a title and, optionally, a body, assignees, labels and a milestone. Returns the created issue, including its number and URL.

Scope

connectors:manage

Calls

POST /v1/connectors/github/repos/{owner}/{repo}/issues

Example prompt

Open a GitHub issue in atlas-org/web titled Login button does nothing.

Arguments

atlas_connectors_github_issues_list

List issues in a GitHub repository, filtered by state, labels, assignee and creator. Returns one page of issues. Use it to review open work in a repository or to find an issue number.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/issues

Example prompt

List the open bug issues in atlas-org/web on GitHub.

Arguments

atlas_connectors_github_issues_search

Search GitHub issues and pull requests with a GitHub search query, such as repo:owner/name is:open label:bug. Returns the total count and one page of matches across repositories.

Scope

connectors:read

Calls

GET /v1/connectors/github/search/issues

Example prompt

Find open GitHub issues labelled bug across atlas-org.

Arguments

atlas_connectors_github_issues_update

Update a GitHub issue by number: change its title or body, close or reopen it, or replace its assignees, labels or milestone. Returns the updated issue. At least one field must be given.

Scope

connectors:manage

Calls

PATCH /v1/connectors/github/repos/{owner}/{repo}/issues/{issueNumber}

Example prompt

Close GitHub issue 42 in atlas-org/web.

Arguments

atlas_connectors_github_orgs_list

List the GitHub organizations the connected GitHub account belongs to. Returns one page of organizations with their logins and descriptions.

Scope

connectors:read

Calls

GET /v1/connectors/github/orgs

Example prompt

Which GitHub organizations does our connected account belong to?

Arguments

atlas_connectors_github_orgs_members_list

List the members of a GitHub organization that the connected GitHub account can see. Returns one page of member logins. Use it to find a login before assigning an issue or requesting a review.

Scope

connectors:read

Calls

GET /v1/connectors/github/orgs/{org}/members

Example prompt

List the members of the atlas-org GitHub organization.

Arguments

atlas_connectors_github_pulls_create

Open a GitHub pull request from a head branch into a base branch, with a title and an optional description, optionally as a draft. Returns the created pull request, including its number and URL.

Scope

connectors:manage

Calls

POST /v1/connectors/github/repos/{owner}/{repo}/pulls

Example prompt

Open a draft pull request from feature/login into main in atlas-org/web.

Arguments

atlas_connectors_github_pulls_get

Get one GitHub pull request by number. Returns its title, body, state, branches, mergeability and review status. Use it before merging or requesting a review.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/pulls/{pullNumber}

Example prompt

Is pull request 128 in atlas-org/web mergeable?

Arguments

atlas_connectors_github_pulls_list

List pull requests in a GitHub repository, filtered by state, head and base branch. Returns one page of pull requests. Use it to see what is waiting for review or merge.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/pulls

Example prompt

Which pull requests are open against main in atlas-org/web?

Arguments

atlas_connectors_github_pulls_merge

Merge a GitHub pull request by number using a merge commit, a squash or a rebase. This changes the base branch on GitHub and cannot be undone from Atlas. Returns the merge result, including the merge commit SHA.

Scope

connectors:manage

Calls

PUT /v1/connectors/github/repos/{owner}/{repo}/pulls/{pullNumber}/merge

Example prompt

Squash-merge pull request 128 in atlas-org/web.

Arguments

atlas_connectors_github_pulls_reviewers_request

Request a review of a GitHub pull request from users, teams or both. GitHub notifies the requested reviewers. Returns the pull request with its updated list of requested reviewers.

Scope

connectors:manage

Calls

POST /v1/connectors/github/repos/{owner}/{repo}/pulls/{pullNumber}/requested-reviewers

Example prompt

Ask octocat to review pull request 128 in atlas-org/web.

Arguments

atlas_connectors_github_pulls_reviews_list

List the reviews submitted on a GitHub pull request by number. Returns each review with its reviewer, state (approved, changes requested or commented) and body.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/pulls/{pullNumber}/reviews

Example prompt

Has anyone approved pull request 128 in atlas-org/web?

Arguments

atlas_connectors_github_releases_create

Create a GitHub release for a tag, creating the tag from a branch or commit when it does not exist, with optional notes, draft and prerelease flags. Returns the created release and its URL.

Scope

connectors:manage

Calls

POST /v1/connectors/github/repos/{owner}/{repo}/releases

Example prompt

Create a draft GitHub release v2.4.0 for atlas-org/web with generated notes.

Arguments

atlas_connectors_github_releases_list

List the releases of a GitHub repository, newest first. Returns one page of releases with their tags, names, notes and whether each is a draft or prerelease.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/releases

Example prompt

What was the latest GitHub release of atlas-org/web?

Arguments

atlas_connectors_github_repos_get

Get one GitHub repository by owner and name through the workspace GitHub connection. Returns the repository details, including its default branch, visibility and counts.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}

Example prompt

Show me the details of the atlas-org/web repository on GitHub.

Arguments

atlas_connectors_github_repos_list

List the GitHub repositories the connected GitHub account can access, filtered by visibility and affiliation and sorted as requested. Returns one page of repositories. Use it to find a repository before working with its issues or code.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos

Example prompt

List my private GitHub repositories, most recently updated first.

Arguments

atlas_connectors_github_repos_search

Search GitHub repositories with a GitHub search query, such as org:atlas language:typescript. Returns the total count and one page of matching repositories.

Scope

connectors:read

Calls

GET /v1/connectors/github/search/repos

Example prompt

Find GitHub repositories in the atlas-org organization written in TypeScript.

Arguments

atlas_connectors_github_task_links_create

Link a GitHub issue or pull request to an Atlas task by its GitHub URL, so the task shows its title and state. Returns the created link. The URL must point at a GitHub issue or pull request.

Scope

connectors:manage

Calls

POST /v1/integrations/github/tasks/{taskId}/links

Example prompt

Link pull request 128 in atlas-org/web to this task.

Arguments

atlas_connectors_github_task_links_delete

Remove the link between an Atlas task and a GitHub issue or pull request. The issue or pull request itself is not changed on GitHub. Returns no content on success.

Scope

connectors:manage

Calls

DELETE /v1/integrations/github/tasks/{taskId}/links/{linkId}

Example prompt

Unlink that GitHub issue from this task.

Arguments

atlas_connectors_github_task_links_list

List the GitHub issues and pull requests linked to an Atlas task. Returns each link with its repository, number, kind, title, state and GitHub URL.

Scope

connectors:read

Calls

GET /v1/integrations/github/tasks/{taskId}/links

Example prompt

Which GitHub pull requests are linked to this task?

Arguments

atlas_connectors_github_user_get

Get the GitHub account the workspace GitHub connection acts as. Returns its login, name and profile details. Use it to confirm which account issues, comments and commits will be attributed to.

Scope

connectors:read

Calls

GET /v1/connectors/github/user

Example prompt

Which GitHub account is our workspace connected as?

Arguments

This tool takes no arguments.

atlas_connectors_github_workflow_runs_get

Get one GitHub Actions workflow run by id. Returns its workflow, branch, commit, triggering event, status, conclusion and timing.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/workflow-runs/{runId}

Example prompt

Show me the status of GitHub Actions run 9876543 in atlas-org/web.

Arguments

atlas_connectors_github_workflow_runs_list

List GitHub Actions workflow runs in a repository, filtered by branch, event, status and actor. Returns one page of runs with their status, conclusion and timing. Use it to check whether a build passed.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/workflow-runs

Example prompt

Did the latest GitHub Actions run on main in atlas-org/web pass?

Arguments

atlas_connectors_github_workflows_list

List the GitHub Actions workflows defined in a repository. Returns one page of workflows with their ids, names, file paths and states. Use it to find the workflow to run.

Scope

connectors:read

Calls

GET /v1/connectors/github/repos/{owner}/{repo}/workflows

Example prompt

Which GitHub Actions workflows does atlas-org/web have?

Arguments

atlas_connectors_github_workflows_run

Trigger a GitHub Actions workflow that accepts manual dispatch, on a branch or tag, with optional inputs. This starts real jobs on GitHub, which may deploy or publish, and cannot be undone from Atlas. Returns an acknowledgement.

Scope

connectors:manage

Calls

POST /v1/connectors/github/repos/{owner}/{repo}/workflows/{workflowId}/dispatches

Example prompt

Run the deploy.yml workflow on main in atlas-org/web.

Arguments

atlas_connectors_gmail_installation_get

Read the Gmail installation of the calling user: the connected address, the sync mode, the trigger label, the default project and when it last synced. Returns connected false when the user has not connected Gmail. No OAuth token is ever returned.

Scope

connectors:read

Calls

GET /v1/integrations/gmail/me

Example prompt

Is my Gmail connected, and how is it syncing?

Arguments

This tool takes no arguments.

atlas_connectors_gmail_installation_revoke

Disconnect the Gmail installation of the calling user. It stops the Gmail push watch, revokes the Google grant and disables the installation, so mail stops syncing until the user connects Gmail again in a browser. Returns no content. Use it only when the user has asked to disconnect.

Scope

connectors:manage

Calls

DELETE /v1/integrations/gmail/me

Example prompt

Disconnect my Gmail from Atlas.

Arguments

This tool takes no arguments.

atlas_connectors_gmail_installation_update

Change how the Gmail installation of the calling user syncs mail into Atlas: the sync mode, the trigger label, or the default project that synced mail lands in. Returns the updated installation. Provide at least one field; the others stay as they are.

Scope

connectors:manage

Calls

PATCH /v1/integrations/gmail/me

Example prompt

Only sync Gmail messages labelled atlas into my Launch project.

Arguments

atlas_connectors_gmail_labels_list

List the labels in the connected Gmail mailbox, system and user labels alike. Returns each label id, name, type and its total and unread message counts. Use it to find the label id that the message list and label tools expect.

Scope

connectors:read

Calls

GET /v1/connectors/gmail/labels

Example prompt

Which labels do I have in Gmail?

Arguments

This tool takes no arguments.

atlas_connectors_gmail_messages_get

Read one Gmail message by id. Returns its header summary: sender, recipient, subject, date, snippet, labels and thread id. The message body is not returned. Use it to inspect a message found by the list tool.

Scope

connectors:read

Calls

GET /v1/connectors/gmail/messages/{id}

Example prompt

Who sent that Gmail message and when?

Arguments

atlas_connectors_gmail_messages_labels_update

Add labels to and remove labels from one Gmail message, for example to star it, archive it by removing INBOX, or mark it read by removing UNREAD. Returns the updated message summary. At least one label to add or remove is required.

Scope

connectors:manage

Calls

POST /v1/connectors/gmail/messages/{id}/labels

Example prompt

Star that Gmail message and mark it read.

Arguments

atlas_connectors_gmail_messages_list

List messages in the connected Gmail mailbox, optionally narrowed by a Gmail search query or label ids. Returns a header summary of each message (sender, recipient, subject, date, snippet and labels) and the next page token. Use it to find mail before reading or labelling it.

Scope

connectors:read

Calls

GET /v1/connectors/gmail/messages

Example prompt

Show my unread Gmail messages from Ana this week.

Arguments

atlas_connectors_gmail_messages_send

Send an email from the connected Gmail account, either as a complete base64url RFC 2822 message or as a plain text message with a recipient, subject and body. The mail leaves the mailbox at once and cannot be recalled. Returns the Gmail message id and thread id.

Scope

connectors:manage

Calls

POST /v1/connectors/gmail/messages/send

Example prompt

Email Ana from my Gmail to say the report is ready.

Arguments

atlas_connectors_gmail_watch_full_sync_run

Run a full resynchronisation of the Gmail mailbox of the calling user and recover the history cursor. Use it when the history replay reports that a full sync is required. Returns a watch summary with how many messages and pages the full sync processed and whether the cursor was recovered.

Scope

connectors:manage

Calls

POST /v1/integrations/gmail/watch/history/recover

Example prompt

Run a full Gmail resync, the history replay says it is needed.

Arguments

This tool takes no arguments.

atlas_connectors_gmail_watch_history_sync

Replay the Gmail history that has arrived since the last processed push notification for the calling user, bringing new mail into Atlas now. Returns a watch summary with how many history records, messages and pages were processed. Use it when synced mail looks behind.

Scope

connectors:manage

Calls

POST /v1/integrations/gmail/watch/history/drain

Example prompt

My synced Gmail looks behind, catch it up now.

Arguments

This tool takes no arguments.

atlas_connectors_gmail_watch_start

Start the Gmail push watch for the calling user, or renew it when one already exists, so new mail reaches Atlas without polling. Returns a watch summary: its status, how many watches are active or expired, and when it next needs renewal. Topic names and history ids are never returned.

Scope

connectors:manage

Calls

POST /v1/integrations/gmail/watch/ensure

Example prompt

Make sure new Gmail messages reach Atlas automatically.

Arguments

This tool takes no arguments.

atlas_connectors_googlecalendar_calendars_list

List the Google calendars the connected account can see. Returns each calendar id, name, description, time zone, whether it is the primary calendar and the access role, plus the next page token. Use it to find the calendar id the event tools expect.

Scope

connectors:read

Calls

GET /v1/connectors/google-calendar/calendars

Example prompt

Which Google calendars can I see?

Arguments

atlas_connectors_googlecalendar_events_create

Create an event in one Google calendar with a title, start and end, and optionally a description, location and attendees. Atlas does not ask Google to email the attendees about it. Returns the created event with its id and link.

Scope

connectors:manage

Calls

POST /v1/connectors/google-calendar/calendars/{calendarId}/events

Example prompt

Add a planning session to my Google Calendar on Friday at 10.

Arguments

atlas_connectors_googlecalendar_events_delete

Delete one event from a Google calendar. The event is removed from the calendar for everyone who can see it, and Atlas cannot bring it back. Returns deleted true. Use it only when the user has asked for the event to be removed.

Scope

connectors:manage

Calls

DELETE /v1/connectors/google-calendar/calendars/{calendarId}/events/{eventId}

Example prompt

Delete the cancelled review from my Google Calendar.

Arguments

atlas_connectors_googlecalendar_events_list

List events in one Google calendar, optionally within a time window or matching free text. Returns each event id, title, time, location, attendees, organizer and link, plus the next page token. Use it to answer what is scheduled or to find an event to change.

Scope

connectors:read

Calls

GET /v1/connectors/google-calendar/calendars/{calendarId}/events

Example prompt

What is on my Google Calendar tomorrow?

Arguments

atlas_connectors_googlecalendar_events_update

Change an existing Google Calendar event: its title, description, start, end, location or attendees. Only the fields given change, but a given attendee list replaces the whole list. Returns the updated event. Provide at least one field.

Scope

connectors:manage

Calls

PATCH /v1/connectors/google-calendar/calendars/{calendarId}/events/{eventId}

Example prompt

Move the planning session in Google Calendar to 11.

Arguments

atlas_connectors_googledrive_files_export_links_get

Read the export links of one Google Drive file, which say which formats a Google Docs, Sheets or Slides file can be exported to and where. Returns the file id, name, MIME type and a map from export MIME type to link. The content itself is not downloaded.

Scope

connectors:read

Calls

GET /v1/connectors/google-drive/files/{fileId}/export

Example prompt

Which formats can I export this Google Doc to?

Arguments

atlas_connectors_googledrive_files_get

Read the metadata of one Google Drive file by id. Returns its name, MIME type, size, parent folders, web link, icon link and created and modified times. The file content is not returned. Use it to confirm which file an id refers to.

Scope

connectors:read

Calls

GET /v1/connectors/google-drive/files/{fileId}

Example prompt

What is that Google Drive file, and when was it last changed?

Arguments

atlas_connectors_googledrive_files_list

List files in the connected Google Drive, optionally narrowed by a Drive search query and sorted. Returns each file id, name, MIME type, size, parent folders, web link and modified time, plus the next page token. Use it to find a file before reading or exporting it.

Scope

connectors:read

Calls

GET /v1/connectors/google-drive/files

Example prompt

Find the launch plan in my Google Drive.

Arguments

atlas_connectors_googledrive_files_upload

Upload a small file to the connected Google Drive from base64 content, at the root or inside a given folder. Each call creates a new file, even when one with the same name exists. Returns the new file with its id, name, size and web link.

Scope

connectors:manage

Calls

PUT /v1/connectors/google-drive/files

Example prompt

Save these meeting notes to my Google Drive as notes.txt.

Arguments

atlas_connectors_googledrive_folders_create

Create a folder in the connected Google Drive, at the root or inside a given parent folder. Returns the new folder with its id, name, parent and web link. Use it to prepare a place for files before uploading them.

Scope

connectors:manage

Calls

POST /v1/connectors/google-drive/folders

Example prompt

Create a Q4 Reports folder in my Google Drive.

Arguments

atlas_connectors_granola_folder_mappings_delete

Remove the routing for one Granola folder, so its meeting notes are no longer recorded against a project, account or engagement. Notes already synced keep what they have. Returns the removed folder id, or a not-found error when the folder has no mapping.

Scope

connectors:manage

Calls

DELETE /v1/connectors/granola/folder-mappings/{folderId}

Example prompt

Stop routing the Acme Granola folder anywhere.

Arguments

atlas_connectors_granola_folder_mappings_list

List where each Granola folder in this workspace is routed: the folder id and name and the project, CRM account and client delivery engagement its meeting notes are recorded against. Use this to answer which client a folder of meeting notes belongs to.

Scope

connectors:read

Calls

GET /v1/connectors/granola/folder-mappings

Example prompt

Which clients are our Granola folders routed to?

Arguments

This tool takes no arguments.

atlas_connectors_granola_folder_mappings_set

Route one Granola folder to a project, a CRM account, a client delivery engagement, or any combination, so the next sync records its meeting notes against them. The mapping is replaced rather than merged, so send every destination the folder should keep. Returns the stored mapping. This does not switch on automatic import of action items.

Scope

connectors:manage

Calls

POST /v1/connectors/granola/folder-mappings

Example prompt

Send notes from the Acme Granola folder to the Acme rollout project.

Arguments

atlas_connectors_granola_folders_list

List the Granola folders visible to the stored tenant connector, with cursor paging. Use the returned folder id to filter the note list to one folder.

Scope

connectors:read

Calls

GET /v1/connectors/granola/folders

Example prompt

Which Granola folders can Atlas see?

Arguments

atlas_connectors_granola_notes_get

Read one Granola note by its vendor id, including the summary and the speaker count that the list route does not carry. The connection selector picks which stored key answers, because a workspace can hold a shared key and several personal ones.

Scope

connectors:read

Calls

GET /v1/connectors/granola/notes/{noteId}

Example prompt

Show me the Granola note for the Northwind kickoff.

Arguments

atlas_connectors_granola_notes_list

List Granola meeting notes through the stored tenant connector, filtered by folder, update time or creation time, with cursor paging. Returns normalized note metadata: title, times, owner, attendees and folder names, never the vendor payload and never the transcript.

Scope

connectors:read

Calls

GET /v1/connectors/granola/notes

Example prompt

List my Granola meeting notes from the last week.

Arguments

atlas_connectors_granola_status_get

Read what this tenant Granola integration is actually doing: each connection with its key scope, last sync, last error, backfill progress, watermark, pending and lost note counts, and whether webhook delivery can be verified at all. No key material is returned.

Scope

connectors:read

Calls

GET /v1/connectors/granola/status

Example prompt

Is the Granola integration syncing, and when did it last run?

Arguments

This tool takes no arguments.

atlas_connectors_granola_sync

Request a Granola sync for one stored connection. The auto mode resumes from the stored watermark; the full mode re-reads everything. The reply says whether the work was queued or run inline, because a queue is not always present and reporting a job that was never created is worse than running it.

Scope

connectors:manage

Calls

POST /v1/connectors/granola/sync

Example prompt

Sync Granola notes now.

Arguments

atlas_connectors_granola_webhooks_create

Register the Granola webhook endpoint for one stored connection so new notes arrive without waiting for the next poll. Fails when the connection has no stored key, because an endpoint registered without one can never be verified.

Scope

connectors:manage

Calls

POST /v1/connectors/granola/webhooks

Example prompt

Register the Granola webhook so new notes arrive immediately.

Arguments

atlas_connectors_granola_webhooks_delete

Remove the Granola webhook endpoint for one stored connection, leaving the connection itself and its stored key in place. Sync continues by polling afterwards.

Scope

connectors:manage

Calls

DELETE /v1/connectors/granola/webhooks

Example prompt

Stop the Granola webhook and fall back to polling.

Arguments

atlas_connectors_hubspot_companies_create

Create a company in the connected HubSpot account from property values such as name and domain, through the workspace HubSpot connection. Returns the new company with its id and properties.

Scope

connectors:manage

Calls

POST /v1/connectors/hubspot/companies

Example prompt

Create a HubSpot company for Acme Ltd.

Arguments

atlas_connectors_hubspot_companies_list

List companies in the connected HubSpot account, with the properties you name. Returns one page of companies with their id, properties, timestamps and archived flag, and the after cursor for the next page.

Scope

connectors:read

Calls

GET /v1/connectors/hubspot/companies

Example prompt

List the companies in HubSpot.

Arguments

atlas_connectors_hubspot_contacts_create

Create a contact in the connected HubSpot account from property values such as email, firstname and lastname. Search first to avoid a duplicate. Returns the new contact with its id and properties.

Scope

connectors:manage

Calls

POST /v1/connectors/hubspot/contacts

Example prompt

Add Ada Lovelace, ada@example.com, to HubSpot.

Arguments

atlas_connectors_hubspot_contacts_get

Get one HubSpot contact by id through the workspace HubSpot connection, with the properties you name. Returns its id, properties, created and updated times, and archived flag.

Scope

connectors:read

Calls

GET /v1/connectors/hubspot/contacts/{contactId}

Example prompt

Show the HubSpot record for this contact.

Arguments

atlas_connectors_hubspot_contacts_list

List contacts in the connected HubSpot account, with the properties you name. Returns one page of contacts with their id, properties, timestamps and archived flag, and the after cursor for the next page.

Scope

connectors:read

Calls

GET /v1/connectors/hubspot/contacts

Example prompt

List our HubSpot contacts with their emails.

Arguments

atlas_connectors_hubspot_contacts_search

Search HubSpot contacts by text or by HubSpot filter groups, with sorting and the properties you name. Returns the matching contacts, the total match count, and the after cursor for the next page.

Scope

connectors:read

Calls

POST /v1/connectors/hubspot/contacts/search

Example prompt

Find HubSpot contacts at acme.com.

Arguments

atlas_connectors_hubspot_contacts_update

Update the property values of an existing HubSpot contact by id through the workspace HubSpot connection. Only the properties you give change. Returns the contact with its id and properties after the change.

Scope

connectors:manage

Calls

PATCH /v1/connectors/hubspot/contacts/{contactId}

Example prompt

Update the phone number on this HubSpot contact.

Arguments

atlas_connectors_hubspot_deals_create

Create a deal in the connected HubSpot account from property values such as dealname, amount, pipeline and dealstage, through the workspace HubSpot connection. Returns the new deal with its id and properties.

Scope

connectors:manage

Calls

POST /v1/connectors/hubspot/deals

Example prompt

Create a HubSpot deal for the Acme renewal worth 20,000.

Arguments

atlas_connectors_hubspot_deals_list

List deals in the connected HubSpot account, with the properties you name such as dealname, amount and dealstage. Returns one page of deals with their id and properties, and the after cursor for the next page.

Scope

connectors:read

Calls

GET /v1/connectors/hubspot/deals

Example prompt

Show our HubSpot deals with amount and stage.

Arguments

atlas_connectors_hubspot_owners_list

List the owners in the connected HubSpot account, optionally only the one with a given email. Use it to find the owner id to assign a contact or a deal. Returns owners with id, email and name, and the after cursor.

Scope

connectors:read

Calls

GET /v1/connectors/hubspot/owners

Example prompt

Who are the deal owners in HubSpot?

Arguments

atlas_connectors_linear_issues_comments_create

Add a comment to a Linear issue using the stored Linear connector credentials.

Scope

connectors:manage

Calls

POST /v1/connectors/linear/issues/{issueId}/comments

Example prompt

Comment on Linear issue LIN-42 that the evidence pack is ready.

Arguments

atlas_connectors_linear_issues_create

Create a Linear issue from normalized Atlas input using the encrypted Linear connector. Runs single-attempt because Linear issue creates are not provider-idempotent.

Scope

connectors:manage

Calls

POST /v1/connectors/linear/issues

Example prompt

Create a Linear issue for the connector launch checklist.

Arguments

atlas_connectors_linear_issues_list

List Linear issues through the stored connector, optionally filtered to one team.

Scope

connectors:read

Calls

GET /v1/connectors/linear/issues

Example prompt

Show the latest Linear issues for team team_1.

Arguments

atlas_connectors_linear_issues_update

Patch a Linear issue by id, stripping the route id from the JSON body and requiring at least one mutable field.

Scope

connectors:manage

Calls

PATCH /v1/connectors/linear/issues/{issueId}

Example prompt

Move Linear issue LIN-42 to priority 1.

Arguments

atlas_connectors_linear_legacy_connection_revoke

Disconnect the workspace Linear connection through the legacy integration route by marking the active connection revoked. Calling it when nothing is connected succeeds and changes nothing. Returns ok. Reconnecting needs a person to supply credentials again in Atlas.

Scope

connectors:manage

Calls

POST /v1/integrations/linear/disconnect

Example prompt

Disconnect Linear.

Arguments

This tool takes no arguments.

atlas_connectors_linear_legacy_status_get

Read the legacy Linear integration connection status without exposing API keys or connector credential material.

Scope

connectors:read

Calls

GET /v1/integrations/linear/status

Example prompt

Is the legacy Linear integration connected?

Arguments

This tool takes no arguments.

atlas_connectors_linear_legacy_sync

Verify the workspace Linear connection by reading up to ten issues through it and recording a successful test. Nothing is imported. Returns an operation id; the work has already finished when it returns. Fails with a conflict when Linear is not connected.

Scope

connectors:manage

Calls

POST /v1/integrations/linear/sync-now

Example prompt

Check the Linear integration can still read issues.

Arguments

This tool takes no arguments.

atlas_connectors_linear_teams_list

List accessible Linear teams through the stored tenant connector, with cursor paging.

Scope

connectors:read

Calls

GET /v1/connectors/linear/teams

Example prompt

List the first 25 Linear teams I can access.

Arguments

atlas_connectors_linear_webhooks_create

Create a Linear webhook for one team or all public teams, enforcing HTTPS callback URLs.

Scope

connectors:manage

Calls

POST /v1/connectors/linear/webhooks

Example prompt

Create a Linear Issue webhook for team team_1.

Arguments

atlas_connectors_list

List the Atlas connector catalog plus the calling tenant's current connection summaries without exposing stored secrets.

Scope

connectors:read

Calls

GET /v1/connectors

Example prompt

List the connectors available to this tenant.

Arguments

This tool takes no arguments.

atlas_connectors_microsoft365_calendar_events_create

Create an event in the default Outlook calendar of the connected Microsoft 365 user, optionally with attendees and a Teams meeting. When attendees are given, Microsoft 365 sends each of them the invitation at once. Returns the created event with its id, web link and online meeting link.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/calendar/events

Example prompt

Book a Teams meeting with Ana in Outlook on Friday at 10.

Arguments

atlas_connectors_microsoft365_calendar_events_list

List events in the default Outlook calendar of the connected Microsoft 365 user. Returns each event id, subject, start, end, time zone, location, organizer, web link and online meeting link, with paging information. Use it to answer what is scheduled.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/calendar/events

Example prompt

What is on my Outlook calendar?

Arguments

atlas_connectors_microsoft365_calendars_list

List the Outlook calendars of the connected Microsoft 365 user. Returns each calendar id, name, color, owner, whether the user can edit it and whether it is the default calendar. Use it to see which calendars exist before reading events.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/calendars

Example prompt

Which Outlook calendars do I have?

Arguments

atlas_connectors_microsoft365_channel_messages_send

Send a Teams channel message through Microsoft Graph with idempotent retry protection.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/teams/{teamId}/channels/{channelId}/messages

Example prompt

Post the release note into the Engineering Teams channel.

Arguments

atlas_connectors_microsoft365_chat_messages_send

Send a Microsoft Teams chat message through Microsoft Graph with idempotent retry protection.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/teams/chats/{chatId}/messages

Example prompt

Send a Teams chat message that the connector proof is complete.

Arguments

atlas_connectors_microsoft365_contacts_create

Create an Outlook contact for the connected Microsoft 365 user with a name and, optionally, email addresses, a mobile phone, a company and a job title. The contact is told nothing. Returns the new contact with its id. At least one of the name fields is required.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/contacts

Example prompt

Add Ana Lee from Contoso to my Outlook contacts.

Arguments

atlas_connectors_microsoft365_contacts_list

List the Outlook contacts of the connected Microsoft 365 user. Returns each contact id, display name, first and last name, email addresses, mobile phone, company and job title, with paging information. Use it to look up a person the user knows.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/contacts

Example prompt

Show my Outlook contacts.

Arguments

atlas_connectors_microsoft365_directory_users_get

Read one person in the Microsoft Entra directory of the connected organisation by user id or user principal name. Returns their display name, user principal name, email, job title, department and office location.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/directory/users/{userId}

Example prompt

What is the job title of ana@contoso.com in our directory?

Arguments

atlas_connectors_microsoft365_directory_users_list

List people in the Microsoft Entra directory of the connected organisation. Returns each user id, display name, user principal name, email, job title, department and office, with paging information. Use the search tool instead when looking for one person.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/directory/users

Example prompt

List people in our Microsoft 365 directory.

Arguments

atlas_connectors_microsoft365_directory_users_search

Search the Microsoft Entra directory of the connected organisation for people whose display name or email address matches the text given. Returns each user id, display name, user principal name, email, job title, department and office, with paging information.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/directory/users/search

Example prompt

Find Ana in our Microsoft 365 directory.

Arguments

atlas_connectors_microsoft365_drive_files_upload

Upload a small file to the OneDrive of the connected Microsoft 365 user from base64 content, at a folder path under the root. A file already at that path with that name is replaced. Returns the uploaded item with its id, size and web link.

Scope

connectors:manage

Calls

PUT /v1/connectors/microsoft-365/drive/files

Example prompt

Save this summary to OneDrive under Reports as q4.txt.

Arguments

atlas_connectors_microsoft365_drive_items_get

Read the metadata of one OneDrive item of the connected Microsoft 365 user by id. Returns its name, size, whether it is a file or folder, MIME type, web link, modified time and, for a file, a short-lived download link that needs no further sign-in.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/drive/items/{itemId}

Example prompt

Give me the details of that OneDrive file.

Arguments

atlas_connectors_microsoft365_drive_items_list

List the files and folders in one OneDrive folder of the connected Microsoft 365 user, or in the root when no folder is given. Returns each item id, name, size, whether it is a file or folder, child count, web link and modified time, with paging information.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/drive/items

Example prompt

What is in the Reports folder of my OneDrive?

Arguments

atlas_connectors_microsoft365_inbox_messages_list

List Outlook inbox message metadata through Microsoft Graph without returning message body text.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/mail/inbox

Example prompt

Show the latest 10 Microsoft 365 inbox messages.

Arguments

atlas_connectors_microsoft365_legacy_connection_revoke

Disconnect your own Microsoft 365 connection through the legacy integration route by marking it revoked. Calling it when nothing is connected succeeds and changes nothing. Returns ok. Reconnecting needs you to sign in to Microsoft again in Atlas.

Scope

connectors:manage

Calls

POST /v1/integrations/microsoft/disconnect

Example prompt

Disconnect my Microsoft 365 account.

Arguments

This tool takes no arguments.

atlas_connectors_microsoft365_legacy_status_get

Read the legacy Microsoft 365 integration connection status without exposing OAuth tokens or connector credential material.

Scope

connectors:read

Calls

GET /v1/integrations/microsoft/status

Example prompt

Is the legacy Microsoft 365 integration connected?

Arguments

This tool takes no arguments.

atlas_connectors_microsoft365_legacy_sync

Verify your Microsoft 365 connection by reading five inbox messages and five Teams through Microsoft Graph and recording a successful test. Nothing is imported. Returns an operation id; the work has already finished when it returns. Fails when you are not connected or a read permission is missing.

Scope

connectors:manage

Calls

POST /v1/integrations/microsoft/sync-now

Example prompt

Check my Microsoft 365 connection can read mail and Teams.

Arguments

This tool takes no arguments.

atlas_connectors_microsoft365_mail_send

Send Outlook mail through Microsoft Graph with bounded recipients, content, and idempotent retry protection.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/mail/send

Example prompt

Send the customer a Microsoft 365 status email.

Arguments

atlas_connectors_microsoft365_mail_subscriptions_create

Create a Microsoft Graph inbox notification subscription using server-owned callback/client-state configuration or a validated HTTPS override.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/mail/subscriptions

Example prompt

Create a Microsoft 365 inbox subscription for created and updated messages.

Arguments

atlas_connectors_microsoft365_mail_subscriptions_get

Read the durable Microsoft Graph mail subscription proof without exposing webhook client-state secrets.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/mail/subscriptions/readback

Example prompt

Check whether the Microsoft 365 inbox subscription needs renewal.

Arguments

This tool takes no arguments.

atlas_connectors_microsoft365_presence_get

Read the Microsoft Teams presence of the connected Microsoft 365 user. Returns their availability, such as Available, Busy or Away, their current activity and their status message. Use it to tell whether the user is free to be reached now.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/presence

Example prompt

Am I showing as busy in Teams right now?

Arguments

This tool takes no arguments.

atlas_connectors_microsoft365_teams_channels_list

List channels for one Microsoft Team through delegated Microsoft Graph access.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/teams/{teamId}/channels

Example prompt

List channels for Microsoft Team team_1.

Arguments

atlas_connectors_microsoft365_teams_list

List Microsoft Teams visible to the connected Microsoft 365 user.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/teams

Example prompt

List my Microsoft Teams workspaces.

Arguments

atlas_connectors_microsoft365_todo_lists_list

List the Microsoft To Do task lists of the connected Microsoft 365 user. Returns each list id, name, well-known list name, and whether the user owns it and whether it is shared. Use it to find the list id the To Do task tools expect.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/todo/lists

Example prompt

Which Microsoft To Do lists do I have?

Arguments

atlas_connectors_microsoft365_todo_tasks_create

Create a task in one Microsoft To Do list of the connected Microsoft 365 user, with a title and optionally notes, importance, status and a due date. Returns the new task with its id, status and due date.

Scope

connectors:manage

Calls

POST /v1/connectors/microsoft-365/todo/lists/{listId}/tasks

Example prompt

Add send the deck to my Microsoft To Do list, due Friday.

Arguments

atlas_connectors_microsoft365_todo_tasks_list

List the tasks in one Microsoft To Do list of the connected Microsoft 365 user. Returns each task id, title, status, importance, reminder flag, due date and created and modified times, with paging information.

Scope

connectors:read

Calls

GET /v1/connectors/microsoft-365/todo/lists/{listId}/tasks

Example prompt

What is left on my Microsoft To Do work list?

Arguments

atlas_connectors_notion_blocks_children_add

Append blocks to the end of a Notion block or page, such as paragraphs, headings or to-do items, through the workspace Notion connection. Returns the blocks Notion created.

Scope

connectors:manage

Calls

PATCH /v1/connectors/notion/blocks/{blockId}/children

Example prompt

Add these action items to the end of the Notion meeting page.

Arguments

atlas_connectors_notion_blocks_children_list

List the child blocks of a Notion block or page, which is how the body of a page is read. Returns one page of Notion block objects, whether more exist, and the cursor for the next page.

Scope

connectors:read

Calls

GET /v1/connectors/notion/blocks/{blockId}/children

Example prompt

Read the content of the Notion onboarding page.

Arguments

atlas_connectors_notion_database_pages_list

Query a Notion database for its pages, with an optional Notion filter and sorts. Use it to read the rows of a tracker or a table. Returns one page of Notion pages, whether more exist, and the next cursor.

Scope

connectors:read

Calls

POST /v1/connectors/notion/databases/{databaseId}/query

Example prompt

Show the open items in our Notion bug tracker database.

Arguments

atlas_connectors_notion_pages_create

Create a Notion page under a database or another page, with its properties and optional body blocks, through the workspace Notion connection. Returns the new page id, URL, archived flag and timestamps.

Scope

connectors:manage

Calls

POST /v1/connectors/notion/pages

Example prompt

Create a Notion page for the Acme kickoff notes.

Arguments

atlas_connectors_notion_pages_update

Update the properties of a Notion page, or move it to the Notion trash or back by setting archived. Give at least one of the two. Returns the page id, URL, archived flag and timestamps after the change.

Scope

connectors:manage

Calls

PATCH /v1/connectors/notion/pages/{pageId}

Example prompt

Mark that Notion page as Done.

Arguments

atlas_connectors_notion_search

Search the pages and databases the workspace Notion connection can see, by title text, optionally filtered and sorted. Returns one page of Notion objects, whether more exist, and the cursor for the next page.

Scope

connectors:read

Calls

POST /v1/connectors/notion/search

Example prompt

Find the Q3 roadmap page in Notion.

Arguments

atlas_connectors_notion_users_list

List the people and bots in the connected Notion workspace. Use it to find the Notion user id to put in a people property. Returns one page of Notion users, whether more exist, and the next cursor.

Scope

connectors:read

Calls

GET /v1/connectors/notion/users

Example prompt

Who has access to our Notion workspace?

Arguments

atlas_connectors_oauth_start

Create a browser authorization URL for an OAuth connector. Forces the REST endpoint to return JSON instead of issuing a redirect.

Scope

connectors:read

Calls

GET /v1/connectors/{connectorId}/oauth/start

Example prompt

Start OAuth for the Microsoft 365 connector.

Arguments

atlas_connectors_operations_list

List the operations Atlas can run against one connected service that is served by the shared operations layer, such as Jira, Asana, Zoom, GitLab or Zendesk. Each entry has an operation id, a one-line summary, and whether it reads or writes. Use this before atlas_connectors_operations_run to find the operation id to call.

Scope

connectors:read

Calls

GET /v1/connectors/{connectorId}/operations

Example prompt

What can Atlas do in Jira?

Arguments

atlas_connectors_operations_run

Run one declared operation against a connected service through the workspace connection, for example searching Jira issues or creating an Asana task. An operation marked as a write changes data in that service. Returns the normalized result the operation produces. Find the operation id and its arguments with atlas_connectors_operations_list first.

Scope

connectors:manage

Calls

POST /v1/connectors/{connectorId}/operations/{operationId}

Example prompt

Search Jira for open issues in project ATL.

Arguments

atlas_connectors_readiness_catalog_get

Read the enterprise integrations readiness catalog with privacy-safe status, setup, and policy metadata and no credential material.

Scope

connectors:read

Calls

GET /v1/integrations/catalog

Example prompt

Show the integration readiness catalog and setup blockers.

Arguments

This tool takes no arguments.

atlas_connectors_slack_bookmarks_add

Add a bookmark to the bookmarks bar of a Slack channel, with a title and a link and an optional emoji. Use it to pin a runbook, a board or a document to a channel. Returns the new bookmark.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/bookmarks

Example prompt

Bookmark the launch runbook in the #launch channel.

Arguments

atlas_connectors_slack_channels_list

List Slack channels available to a Slack installation (paginated).

Scope

webhooks:manage

Calls

GET /v1/integrations/slack/installations/{id}/channels

Example prompt

What Slack channels can I link to projects?

Arguments

atlas_connectors_slack_conversations_create

Create a Slack channel in the connected workspace, public by default or private when asked. The name must be lowercase letters, numbers, hyphens and underscores. Returns the new channel id and name.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/conversations

Example prompt

Create a private Slack channel called acme-onboarding.

Arguments

atlas_connectors_slack_conversations_get

Get one Slack conversation by id through the workspace connection. Returns its name, whether it is private or archived, its topic, its purpose and its member count, where Slack reports them.

Scope

connectors:read

Calls

GET /v1/connectors/slack/conversations/{channelId}

Example prompt

What is the topic of the #launch Slack channel?

Arguments

atlas_connectors_slack_conversations_history_list

Read the message history of a Slack conversation, newest first, optionally bounded by oldest and latest ts. Returns one page of messages with author, text, ts and thread details, whether more exist, and the cursor for the next page.

Scope

connectors:read

Calls

GET /v1/connectors/slack/conversations/{channelId}/history

Example prompt

Summarise what was said in #launch today.

Arguments

atlas_connectors_slack_conversations_list

List the Slack conversations the workspace connection can see, filtered by type and optionally leaving archived ones out. Returns one page of conversations with their id and name, and the cursor for the next page.

Scope

connectors:read

Calls

GET /v1/connectors/slack/conversations

Example prompt

Which Slack channels can Atlas see?

Arguments

atlas_connectors_slack_conversations_members_invite

Invite one or more Slack users, by Slack user id, into a Slack conversation through the workspace connection. Returns the conversation after the invitation, as Slack reports it.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/conversations/{channelId}/invite

Example prompt

Add Priya and Tom to the #acme-onboarding Slack channel.

Arguments

atlas_connectors_slack_conversations_members_list

List the members of a Slack conversation through the workspace connection. Returns one page of Slack user ids and the cursor for the next page; look a person up with the Slack users get tool.

Scope

connectors:read

Calls

GET /v1/connectors/slack/conversations/{channelId}/members

Example prompt

Who is in the #launch Slack channel?

Arguments

atlas_connectors_slack_files_upload

Upload text content to Slack as a file, optionally shared into a channel or a thread with a title and a message. Use it to share notes, a report or a log. Returns the uploaded files with their id, name, title and permalink.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/files

Example prompt

Share these meeting notes as a file in #launch.

Arguments

atlas_connectors_slack_installations_delete

Remove a Slack installation from this Atlas workspace. Atlas asks Slack to revoke the bot access and deletes the installation, so Slack notifications and commands stop until someone installs the app again. Returns nothing.

Scope

connectors:manage

Calls

DELETE /v1/integrations/slack/{id}

Example prompt

Uninstall the Slack app from our Atlas workspace.

Arguments

atlas_connectors_slack_installations_list

List the Slack app installations of this Atlas workspace. Returns each installation with its id, Slack team id and name, bot user id, default channel, who installed it, when, and the granted Slack scopes.

Scope

connectors:read

Calls

GET /v1/integrations/slack

Example prompt

Show the Slack installations for this workspace.

Arguments

This tool takes no arguments.

atlas_connectors_slack_installations_update

Set or clear the default Slack channel of a Slack installation, which is where Atlas posts notifications when nothing more specific is linked. Returns the updated installation.

Scope

connectors:manage

Calls

PATCH /v1/integrations/slack/{id}

Example prompt

Make #announcements the default Slack channel for Atlas.

Arguments

atlas_connectors_slack_messages_delete

Delete a Slack message by channel and ts. The deletion is permanent in Slack and cannot be undone, so confirm with the person first. Returns the channel and the ts that were deleted.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/chat/messages/delete

Example prompt

Delete the Slack message the bot posted by mistake in #general.

Arguments

atlas_connectors_slack_messages_pin

Pin a Slack message to its channel, identified by channel and message ts, so it appears in the channel pinned items. Use it to keep a decision or a link in view. Returns the Slack acknowledgement.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/pins

Example prompt

Pin the decision message in #launch.

Arguments

atlas_connectors_slack_messages_schedule

Schedule a Slack message to post at a future time, given as Unix seconds, with text, Block Kit blocks or both. Returns the scheduled message id, the channel and the time it will post.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/chat/scheduled-messages

Example prompt

Schedule a Slack reminder in #team for 9 tomorrow morning.

Arguments

atlas_connectors_slack_messages_search

Search Slack messages across the connected workspace with a Slack search query, sorted by relevance or time. Returns the total match count and the matching messages with their channel, author, text and permalink.

Scope

connectors:read

Calls

GET /v1/connectors/slack/search/messages

Example prompt

Find the Slack messages about the pricing change last week.

Arguments

atlas_connectors_slack_messages_send

Post a message to a Slack channel, group or direct message through the workspace Slack connection, as text, Block Kit blocks or both, optionally as a thread reply. Returns the channel and the ts of the posted message.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/chat/messages

Example prompt

Post that the release is out in the #launch Slack channel.

Arguments

atlas_connectors_slack_messages_update

Edit a Slack message the workspace connection posted, replacing its text, its Block Kit blocks or both. Identify the message by channel and ts. Returns the channel and the ts of the edited message.

Scope

connectors:manage

Calls

PATCH /v1/connectors/slack/chat/messages

Example prompt

Fix the typo in the Slack message I just posted to #launch.

Arguments

atlas_connectors_slack_reactions_add

Add an emoji reaction to a Slack message, identified by channel and message ts, as the workspace Slack connection. Use it to acknowledge a message. Returns the Slack acknowledgement.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/reactions

Example prompt

React with a checkmark to the latest message in #support.

Arguments

atlas_connectors_slack_reactions_remove

Remove an emoji reaction the workspace Slack connection added to a message, identified by channel, message ts and emoji name. Returns the Slack acknowledgement.

Scope

connectors:manage

Calls

POST /v1/connectors/slack/reactions/remove

Example prompt

Remove the eyes reaction from that Slack message.

Arguments

atlas_connectors_slack_team_get

Get the connected Slack workspace itself through the workspace connection. Returns its team id, name and domain. Use it to confirm which Slack workspace the connection points at.

Scope

connectors:read

Calls

GET /v1/connectors/slack/team

Example prompt

Which Slack workspace is Atlas connected to?

Arguments

This tool takes no arguments.

atlas_connectors_slack_usergroups_list

List the user groups in the connected Slack workspace, such as @engineering, optionally including disabled ones. Returns each group with its id, handle, name and member count.

Scope

connectors:read

Calls

GET /v1/connectors/slack/usergroups

Example prompt

What Slack user groups do we have?

Arguments

atlas_connectors_slack_users_by_email_get

Find the Slack user who holds an email address in the connected workspace. Use it to turn an Atlas person into a Slack user id before mentioning or inviting them. Returns that Slack user.

Scope

connectors:read

Calls

GET /v1/connectors/slack/users/lookup-by-email

Example prompt

Find the Slack account for priya@example.com.

Arguments

atlas_connectors_slack_users_get

Get one Slack user by Slack user id through the workspace connection. Returns their name, display name, email where visible, time zone and whether they are a bot or deactivated.

Scope

connectors:read

Calls

GET /v1/connectors/slack/users/{userId}

Example prompt

What time zone is this Slack user in?

Arguments