Exports
Export operations send session content (summary, transcript, notes, action items, markers and audio) to files, an Obsidian vault or Notion. All of them are on by default in MCP Access. Every operation also takes an optional workspaceId. See How to read this reference for the conventions.
| Operation | Kind | Tool | On | Group |
|---|---|---|---|---|
exports.config | Read | talkbar_read | On | exports |
exports.sessions | Read | talkbar_read | On | exports |
exports.preview | Read | talkbar_read | On | content |
exports.enqueue | Write | talkbar_change | On | exports |
exports.run | Write | talkbar_change | On | exports |
exports.status | Read | talkbar_read | On | exports |
exports.runs | Read | talkbar_read | On | exports |
exports.history | Read | talkbar_read | On | exports |
exports.cancel | Write | talkbar_change | On | exports |
exports.retry | Write | talkbar_change | On | exports |
exports.resolve | Write | talkbar_change | On | exports |
exports.destination.save | Write | talkbar_change | On | exports |
exports.destination.delete | Write | talkbar_delete | On | exports |
exports.rule.save | Write | talkbar_change | On | exports |
exports.rule.delete | Write | talkbar_delete | On | exports |
How an export runs
- Set up a destination with
exports.destination.save(or in the app). - Check what will be written with
exports.preview. - Queue a batch with
exports.enqueue, then callexports.rununtil no delivery is leftscheduled. Check progress withexports.status. - If a delivery needs attention because the destination was changed outside TalkBar, settle it with
exports.resolve, or try again withexports.retry.
A delivery is scheduled, waitingForSummary, waitingForAudio, exporting, exported, partiallyExported, needsAttention or cancelled; a batch takes its status from its deliveries.
exports.config
Reads the workspace's export destinations and automatic export rules.
Read · runs with talkbar_read · MCP switch On by default · policy group exports
Arguments: none besides workspaceId.
Returns: {destinations, rules}. Destinations have destinationId, name, format, location, enabled, layout and credentialRef; rules have the fields exports.rule.save takes.
{"tool": "exports.config", "args": {}}
exports.sessions
Pages the ids of the sessions that can be exported (complete and not in the Trash), optionally within a project or series.
Read · runs with talkbar_read · MCP switch On by default · policy group exports
Arguments
Only sessions of this project.
Only sessions of this series.
The last session id of the previous page.
How many to return. From 1 to 100. Default 100.
Returns: An array of session ids, in id order. Pass the last one as after for the next page; an empty array means the end.
exports.preview
Shows what an export would contain and whether each session is ready, without exporting anything.
Read · runs with talkbar_read · MCP switch On by default · policy group content
Arguments
The sessions to export. 1 to 100.
The destinations to preview. 1 to 10. Each must exist and be enabled.
What to include from each session. Unknown keys are refused.
summary(defaulttrue),transcript(defaulttrue),metadata(defaulttrue),notes,outcomes(action items),markers(each defaultfalse).audio:none(default),original,mp4,mp3orwav.summarySectionKeys: only these summary sections. Empty means the whole summary.turnIds: only these transcript turns (up to 10,000).ranges: only transcript turns inside these time ranges,[{startMs, endMs}]in ms from the session start (up to 100).
Returns: {sessions, destinations, outputs}. Each session shows the selected content, ready and, when it is not ready, waitReason (sessionNotFinished, summaryMissing, summaryStale or audioPending). Each output names the location, files and archiveEntries it would write.
- Returns the selected summary and transcript text, so its policy group is
content.
{"tool": "exports.preview", "args": {"sessionIds": ["ses_123"], "destinationIds": ["dest_vault"], "selection": {"summary": true, "transcript": false, "outcomes": true}}}
exports.enqueue
Queues sessions for export to one or more destinations, as a batch.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
The sessions to export. 1 to 100.
The destinations. 1 to 10. Each must exist and be enabled.
What to include, as for exports.preview.
Returns: The batch: {batchId, workspaceId, status, automatic, createdAtMs, deliveries}. Each delivery has deliveryId, sessionId, sessionTitle, destinationId, status, location, error, conflict and updatedAtMs.
- A session that is still recording is refused with
session_recording: queue it after it stops. - Queuing does not deliver anything by itself. Run it with
exports.run, or cancel it withexports.cancel.
{"tool": "exports.enqueue", "args": {"sessionIds": ["ses_123", "ses_124"], "destinationIds": ["dest_vault"]}}
exports.run
Runs a small part of one batch now: each call delivers at most one session to one destination. It never starts a background worker.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
The export batch, from exports.enqueue or exports.history.
Returns: The batch after the run ({batchId, workspaceId, status, automatic, createdAtMs, deliveries}. Each delivery has deliveryId, sessionId, sessionTitle, destinationId, status, location, error, conflict and updatedAtMs).
- Call it again while the batch still has scheduled deliveries.
- One export run at a time: a second call while one is running is answered
busywithretryAfterMs: 5000. - Writes files or Notion pages to the destination.
{"tool": "exports.run", "args": {"batchId": "batch_5"}}
exports.status
Reads the delivery status of one export batch.
Read · runs with talkbar_read · MCP switch On by default · policy group exports
Arguments
The export batch, from exports.enqueue or exports.history.
Returns: The batch: {batchId, workspaceId, status, automatic, createdAtMs, deliveries}. Each delivery has deliveryId, sessionId, sessionTitle, destinationId, status, location, error, conflict and updatedAtMs.
exports.runs
Lists the delivery attempts of one export batch.
Read · runs with talkbar_read · MCP switch On by default · policy group exports
Arguments
The export batch, from exports.enqueue or exports.history.
Returns: An array of attempts: [{runId, deliveryId, status, startedAtMs, finishedAtMs, error}].
exports.history
Lists recent export batches, newest first.
Read · runs with talkbar_read · MCP switch On by default · policy group exports
Arguments
How many to return. From 1 to 100. Default 30.
Returns: An array of batches, as exports.status returns them.
exports.cancel
Cancels an export batch. Deliveries that finished stay exported.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
The export batch, from exports.enqueue or exports.history.
Returns: The batch as it now stands.
- Every delivery that is not
exportedbecomescancelled, including partly exported ones and ones that need attention.
exports.retry
Retries an export batch: partly exported deliveries and deliveries that need attention (other than conflicts) are queued again.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
The export batch, from exports.enqueue or exports.history.
Returns: The batch as it now stands.
- Conflicts are settled with
exports.resolveinstead. A finished batch is unchanged.
exports.resolve
Settles an export conflict, where the file or page at the destination was changed outside TalkBar.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
The delivery that needs attention, from the batch.
keepExternal keeps the outside version, saveCopy writes TalkBar's version as a new copy, replace overwrites the outside version.
Returns: The batch as it now stands.
- Only a delivery that needs attention can be resolved.
{"tool": "exports.resolve", "args": {"deliveryId": "dlv_9", "action": "saveCopy"}}
exports.destination.save
Creates or updates an export destination: a folder of files, an Obsidian vault, a folder for Notion import, or a connected Notion page.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
An id you choose. Saving with an existing id updates that destination.
The destination name. Must not be empty.
What to write:
txt,markdown,html,json,srt,vtt,zip: files in a folder.obsidian: Markdown with properties, for an Obsidian vault.notionMarkdown: Markdown files for Notion's import.notion: pages created in a connected Notion workspace.
For notion, the parent page (an id or a page URL). For every other format, an absolute folder path.
Whether the destination can be used.
How files are arranged in the folder: flat (default), project, series or projectSeries.
For a connected Notion destination, the stored connection: exactly export:<workspaceId>:<destinationId>, or null. Connecting Notion happens in the app; an assistant cannot store a token.
Returns: The destination as saved.
- Saving replaces the whole destination: leaving
credentialRefout of a connected Notion destination disconnects it. - Administrator rules can limit which folders or destinations may be used.
{"tool": "exports.destination.save", "args": {"destinationId": "dest_vault", "name": "Obsidian vault", "format": "obsidian", "location": "PATH_TO_VAULT/Meetings", "enabled": true, "layout": "project"}}
exports.destination.delete
Removes a destination that has no active deliveries. Files and pages already exported are kept.
Write · runs with talkbar_delete · MCP switch On by default · policy group exports
Arguments
The export destination, from exports.config.
Returns: {deleted: true, switchedOffRules}. A rule of its own (override) left with no destination is switched to disabled and listed in switchedOffRules.
- Refused with
failedwhile a delivery to it is scheduled, waiting or exporting. - Also removes any stored Notion connection for the destination.
- Runs with
talkbar_delete: confirmed with you when your AI app can ask; apps that cannot ask are refused unless Allow deletes without confirmation is on.
exports.rule.save
Sets automatic export for the workspace, a project or a series.
Write · runs with talkbar_change · MCP switch On by default · policy group exports
Arguments
An id you choose. Saving again with the same id updates the rule.
workspace, project or series.
The workspace, project or series id. For workspace, the workspace id itself.
inherit (use the rule above; not allowed for the workspace), override (use this rule) or disabled (no automatic export here).
The destinations to export to.
What to include, as for exports.preview.
When to export. One of:
{"kind": "ready"}: as soon as a session is ready.{"kind": "delay", "delayMs": …}: a delay after it is ready, up to 31 days (2,678,400,000 ms).{"kind": "daily", "hour": …, "minute": …, "timezone": "…"}: once a day at that time, in an IANA time zone.
Export again when the summary changes.
Export again when the transcript changes.
Required, but TalkBar sets the time itself: now, or the earlier time when an override rule stays override.
Returns: The rule as saved.
- One rule per scope: another
ruleIdfor a scope that already has a rule is refused withfailed, naming the existing rule.
{"tool": "exports.rule.save", "args": {"ruleId": "rule_proj456", "scopeKind": "project", "scopeId": "proj_456", "mode": "override", "destinationIds": ["dest_vault"], "selection": {"summary": true, "transcript": true}, "timing": {"kind": "ready"}, "reexportSummary": true, "reexportTranscript": false, "enabledAtMs": 0}}
exports.rule.delete
Removes an automatic export rule. Queued and delivered exports are kept.
Write · runs with talkbar_delete · MCP switch On by default · policy group exports
Arguments
The automatic export rule, from exports.config.
Returns: {deleted: true}.
- Runs with
talkbar_delete: confirmed with you when your AI app can ask; apps that cannot ask are refused unless Allow deletes without confirmation is on.
Related
Chats and documents
MCP and CLI operations to list and read Ask TalkBar chats and documents, read document text, and rename, pin, file, trash and restore them.
Operations reference
Every operation an assistant can run through TalkBar MCP or the TalkBar CLI, with arguments, defaults, permissions and results.