Integration · Productivity

Connect Claude & ChatGPT to Dust

Ask your AI to put a question to one of your Dust agents, or to find something in your workspace data sources. It can start conversations with agents and read their replies, run semantic searches in a data source, and read documents and tables. It can also add or replace documents and table rows, so notes and data end up where your Dust agents can use them.

Connect Dust free

Free plan, no credit card. Takes about a minute.

Try asking

“Ask our Support agent in Dust how refunds are handled.”
The AI finds the agent by name, starts a conversation that mentions it, and reads the agent's reply back to you.
“Where in the workspace do we keep the onboarding checklist?”
It searches documents, tables and folders across the workspace and shows where the matches live.
“Search the Policies data source for our travel rules.”
It finds the space and data source, runs a semantic search and returns the best matching passages.

What your AI can do

Agents and conversations

List and search agents, start conversations, post follow-up messages, attach context and read agent replies.

Search and data sources

List spaces, data sources and views, and run semantic searches in one data source or across the workspace.

Documents and tables

Read, create and replace documents, read table schemas and rows, and add or update rows.

“Save this meeting summary as a document in the Team Notes data source.”
It creates the document with a title and text. If a document with the same ID already exists, it is replaced.
“Show me the first 20 rows of the pricing table.”
It finds the table in the data source and lists its rows, with paging for longer tables.
“Which agents can I use, and what tools does the Research agent have?”
It lists your agents and reads the Research agent's full configuration, including its tools and actions.

117 tools for Dust

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_content_to_conversationChanges dataAttach text or a file to a conversation by `c_id` as context for the agents: `title` plus `content` (or `url`, or a `file_id`).
cancel_messageDeletesCancel a message (c id). Destructive action; may require approval. API summary: Cancel message generation in a conversation.
cancel_message_generationDeletesCancel a message (c id). Destructive action; may require approval. API summary: Cancel message generation.
create_a_content_fragmentChanges dataCreate a new content fragment for a message. Required: title, content, content type or context. API summary: Create a content fragment.
create_a_conversationChanges dataCreate a new message. API summary: Create a conversation.
create_a_file_uploadChanges dataCreate a new document for a w. Required: content type, file name, file size or use case. API summary: Create a file upload.
create_agent_configurationChanges dataCreate a new agent configuration. Required: assistant. Search agent configurations first to avoid duplicates. API summary: Create an agent configuration.
create_app_runChanges dataCreate a new run for a app. Required: specification hash, config or inputs. API summary: Create an app run.
create_conversationChanges dataStart a new Dust conversation with a first `message` (content plus `mentions` with the agent's configurationId to get that agent to answer) and an optional `title`. Read the agent's reply with get_conversation.
create_data_source_tableChanges dataCreate a new table for a data source. API summary: Upsert a table.
create_deregisterChanges dataCreate a new deregister. Required: server id. API summary: Deregister a client-side MCP server.
create_document_parentChanges dataCreate a new parent for a document. API summary: Update the parents of a document.
create_facetChanges dataCreate a new facet. API summary: List consumption analytics facets.
create_heartbeatChanges dataCreate a new heartbeat. Required: server id. API summary: Update heartbeat for a client-side MCP server.
create_message_answer_questionChanges dataCreate a new answer question for a message. Required: action id or answer. API summary: Answer a user question in a conversation message.
create_message_compactionChanges dataCreate a new compaction for a message. Required: model. API summary: Compact a conversation.
create_message_editChanges dataCreate a new edit for a message. Required: content or mentions. API summary: Edit an existing message in a conversation.
create_message_edit_postChanges dataCreate a new edit for a message. Required: content or mentions. API summary: Edit a message.
create_message_feedback_postChanges dataCreate a new feedback for a message. Required: thumb direction. API summary: Submit message feedback.
create_message_participantChanges dataCreate a new participant for a message. API summary: Add a participant to a conversation.
create_message_postChanges dataCreate a new message for a message. Required: content, mentions or context. API summary: Post a message to a conversation.
create_message_retryChanges dataCreate a new retry for a message. API summary: Retry an agent message.
create_message_selected_spaceChanges dataCreate a new selected space for a message. Required: mode or space ids. API summary: Select Spaces for a conversation.
create_parseChanges dataCreate a new parse. Required: markdown. API summary: Parse mentions in markdown text.
create_registerChanges dataCreate a new register. Required: server name. API summary: Register a client-side MCP server.
create_resultChanges dataCreate a new result. Required: result or server id. API summary: Submit MCP tool execution results.
create_revoke_sessionChanges dataCreate a new revoke session. Required: session id. API summary: Revoke a session.
create_space_data_source_viewChanges dataCreate a new data source view for a space. Required: data source id. API summary: Create a data source view.
create_w_documentChanges dataCreate a new document for a w. Required: content type, file name, file size, use case or use case metadata. API summary: Create a file upload URL.
create_w_spaceChanges dataCreate a new space for a w. Required: is restricted, name, space kind or management mode. API summary: Create a space.
delete_a_data_source_viewDeletesPermanently delete a data source view by dsv id. Destructive action; may require approval.
delete_a_messageDeletesPermanently delete a message by m id. Destructive action; may require approval.
delete_agent_configurationDeletesPermanently delete a agent configuration by s id. Destructive action; may require approval. API summary: Archive agent configuration.
delete_data_source_tableDeletesPermanently delete a table by t id. Destructive action; may require approval.
delete_documentDeletesPermanently delete a document from a data source by `space_id`, `ds_id` and `document_id`. Cannot be undone.
delete_messageDeletesPermanently delete a message by c id. Destructive action; may require approval. API summary: Delete or leave a conversation.
delete_message_feedbackMoves moneyPermanently delete a feedback by m id. Financial or irreversible action; may require approval. API summary: Delete feedback for a specific message.
delete_message_feedback_deleteMoves moneyPermanently delete a feedback by m id. Financial or irreversible action; may require approval. API summary: Delete message feedback.
delete_message_wakeupDeletesPermanently delete a wakeup by wu id. Destructive action; may require approval. API summary: Cancel a wake-up.
delete_space_data_source_viewDeletesPermanently delete a data source view by dsv id. Destructive action; may require approval.
delete_table_rowDeletesPermanently delete a row by r id. Destructive action; may require approval.
delete_w_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete a file.
delete_w_skillDeletesPermanently delete a skill by skill id. Destructive action; may require approval. API summary: Archive a skill.
delete_w_spaceDeletesPermanently delete a space by space id. Destructive action; may require approval.
export_analyticsExport analytics. API summary: Export workspace analytics.
get_a_conversationGet one message by c id. API summary: Get a conversation.
get_a_data_source_viewGet one data source view for a space by dsv id. API summary: Get a data source view.
get_a_messageGet one message for a message by m id. API summary: Get a message.
get_agentGet one agent's configuration by `s_id` (agent ID); set `variant` to full to include its tools and actions.
get_an_agent_message_credit_attributionList consumptions for a message. API summary: Get an agent message credit attribution.
get_app_runGet one run for a app by run id. API summary: Get an app run.
get_conversationGet a conversation by `c_id` (conversation ID) with its messages, including agent replies. Page with `limit` and `last_value`.
get_conversation_feedbacksList feedback for a message. API summary: Get conversation feedbacks.
get_documentGet one document's text and metadata from a data source by `space_id`, `ds_id` and `document_id`.
get_events_for_a_messageList events for a message. Optional filters: last event id. API summary: Get events for a message.
get_mention_suggestionsSearch suggestions by query, select or current. Use this to find existing suggestions before creating a new suggestion. API summary: Get mention suggestions.
get_message_actionGet one action for a message by a id. API summary: Get a single action.
get_message_documentGet one document for a message by rel. API summary: Download a conversation-scoped file by path.
get_space_data_source_viewGet one data source view for a space by dsv id. API summary: Get a data source view.
get_tableGet one table's details and schema by `space_id`, `ds_id` and `t_id` (table ID).
get_table_rowGet one row for a table by r id. API summary: Get a row.
get_wGet one w by w id. Results are paginated. API summary: Search for nodes in the workspace (streaming).
get_w_documentGet one document for a w by document id. API summary: Get or download a file.
get_w_spaceGet one space for a w by space id. API summary: Get a space.
list_agent_configurations_getList agent configurations. Optional filters: view, with usage, with authors, with feedbacks, with editors or sort. Results are paginated.
list_agentsList the Dust agents you can use, optionally by `view` (list, workspace, published, global, favorites). Returns each agent's ID for mentioning it in a message.
list_configsList configs. API summary: Get extension configuration.
list_conversationsList messages. API summary: List conversations.
list_data_source_check_upsert_queuesList check upsert queues for a data source. API summary: Check the upsert queue status for a data source.
list_data_source_viewsList the data source views in one space by `space_id`. A view's ID is what search_data_source_view needs.
list_data_source_views_2List data source views for a space. Optional filters: category, with details or include edited by.
list_data_sourcesList the data sources (connected apps, folders, websites) in one space by `space_id`.
list_documentsList documents in a data source by `space_id` and `ds_id`, or fetch specific `document_ids`. Page with `limit` and `offset`.
list_go_templatesList go templates. Optional filters: slug. API summary: Resolve a conversation go template draft.
list_invocation_eventsList events for a invocation. API summary: Stream sandbox function invocation events.
list_message_consumptionsList consumptions for a message. API summary: Get a conversation credit attribution.
list_message_eventsList events for a message. Optional filters: last event id. API summary: Get the events for a conversation.
list_message_events_2List events for a message. API summary: Stream message events.
list_message_events_getList events for a message. API summary: Stream conversation events.
list_message_feedbackList feedback for a message. API summary: Get feedbacks for a conversation.
list_message_participantsList participants for a message. API summary: Get conversation participants.
list_message_selectable_spacesList selectable spaces for a message.
list_message_wakeupsList wakeups for a message. API summary: List wake-ups for a conversation.
list_messagesList messages for a message. API summary: List messages in a conversation.
list_requestsList requests. Optional filters: server id or last event id. API summary: Stream MCP tool requests for a workspace.
list_skillsList the skills available in the workspace, optionally filtered by `status` (active, archived, suggested).
list_space_appsList apps for a space.
list_space_mcp_server_viewsList mcp server views for a space. API summary: List available MCP server views.
list_space_project_notification_preferencesList project notification preferences for a space. API summary: Get project notification preference.
list_spacesList the spaces in your Dust workspace, optionally filtered by `kinds` (e.g. regular,global). Use this first to find the `space_id` other tools need.
list_spaces_2List spaces for a w. Optional filters: role or kind.
list_table_rowsList rows of a table by `space_id`, `ds_id` and `t_id`. Page with `limit` and `offset`.
list_tablesList the tables in a data source by `space_id` and `ds_id`.
list_usersList users. API summary: Get current user.
list_w_feature_flagsList feature flags for a w. API summary: Get workspace feature flags.
list_yamlsList yamls. API summary: Export agent configuration as YAML.
rate_agent_messageChanges dataGive thumbs up or down (`thumb_direction`) on an agent message by `c_id` and `m_id`, with optional `feedback_content` text.
search_agentsFind agents by name with `q`. Returns agent IDs to mention in a conversation.
search_data_sourceSemantic search inside one data source: pass `space_id`, `ds_id`, `query`, `top_k` (number of results) and `full_text` (true to return whole documents). Optional tag, parent and timestamp filters.
search_data_source_viewSemantic search inside one data source view: pass `space_id`, `dsv_id`, `query`, `top_k` and `full_text`. Optional tag, parent and timestamp filters.
search_suggestionsSearch suggestions by query, select or current. Use this to find existing suggestions before creating a new suggestion. API summary: Get mention suggestions for a conversation.
search_suggestions_getSearch suggestions by query, select, current or space id. Use this to find existing suggestions before creating a new suggestion. API summary: Get mention suggestions.
search_workspaceChanges dataSearch documents, tables and folders across the workspace by `query`, optionally limited to `space_ids`. Use to find where something lives before reading it.
send_messageChanges dataPost a new message in an existing conversation by `c_id`, with `content` and `mentions` (agent configurationIds to answer; an empty list triggers no agent).
submit_message_actionVisible to othersValidate a message (m id). Has effects visible outside this system. API summary: Validate an action in a conversation message.
update_agent_configurationChanges dataUpdate an existing agent configuration identified by s id. Only the fields you pass are changed. API summary: Update agent configuration.
update_hookDeletesUpdate an existing hook identified by webhook source id. Destructive action; may require approval. API summary: Receive external webhook to trigger flows.
update_messageChanges dataUpdate an existing message identified by c id. Only the fields you pass are changed. API summary: Update a conversation.
update_space_data_source_viewChanges dataUpdate an existing data source view identified by dsv id. Only the fields you pass are changed. API summary: Update a data source view.
update_space_project_notification_preferencesVisible to othersUpdate an existing project notification preference identified by space id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Set project notification preference.
update_usersVisible to othersUpdate an existing user. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update current user.
update_w_documentChanges dataUpdate an existing document identified by document id. API summary: Upload file content.
update_w_spaceChanges dataUpdate an existing space identified by space id. Only the fields you pass are changed. API summary: Update a space.
upload_agent_configurationChanges dataImport a agent configuration (w id). API summary: Import agent configuration.
upload_toolChanges dataUpload a tool (w id). API summary: Upload a tool file.
upsert_documentChanges dataCreate or replace a document in a data source by `space_id`, `ds_id` and `document_id`, with `title`, `text`, optional `tags` and `source_url`. An existing document with that ID is overwritten.
upsert_table_rowsChanges dataAdd or update rows in a table by `space_id`, `ds_id` and `t_id`: pass `rows` (each with `row_id` and a `value` object). Setting `truncate` to true first deletes all existing rows.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Dust from the app list.
2
Paste your key
Paste three values: your Dust region host (dust.tt for US or eu.dust.tt for Europe), a workspace API key and your workspace ID. A Dust workspace admin creates the API key in the workspace settings under API Keys. The workspace ID is the part after /w/ in your Dust address (dust.tt/w/<workspace ID>/...).
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Dust?

The AI can list and search agents, start conversations with them, post messages and read the replies. It can list spaces, data sources and views, search them, and read documents, tables and table rows. It can also create or replace documents, add or update table rows, attach content to a conversation, rate agent messages and delete documents if you switch those tools on.

Does the AI see my Dust credentials?

No. Your Dust credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with only search and reading. Deleting a document is permanent, and updating table rows with truncate first removes all existing rows. Actions like these can require your approval before they run, and every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Dust account.

Where do I find my Dust workspace ID and region?

Open Dust in your browser and look at the address. The workspace ID is the part after /w/, as in dust.tt/w/<workspace ID>/. If the address starts with eu.dust.tt, your workspace is in Europe and you use eu.dust.tt as the host. Otherwise use dust.tt.