MCP

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.

Chat operations read and organize your Ask TalkBar chats; an assistant cannot send a message in one. Document operations list documents, read their extracted text and rename, pin or file them. Every operation also takes an optional workspaceId. See How to read this reference for the conventions.

OperationKindToolOnGroup
chats.listReadtalkbar_readOncontent
chats.getReadtalkbar_readOncontent
chats.trash.listReadtalkbar_readOncontent
chats.updateWritetalkbar_changeOffcontentChanges
chats.trashWritetalkbar_deleteOffcontentChanges
chats.restoreWritetalkbar_changeOffcontentChanges
documents.listReadtalkbar_readOncontent
documents.getReadtalkbar_readOncontent
documents.readReadtalkbar_readOncontent
documents.updateWritetalkbar_changeOffcontentChanges

chats.list

Pages the AI chats (Ask TalkBar) in a workspace: pinned chats first, then by most recent activity. Messages are not returned.

Read · runs with talkbar_read · MCP switch On by default · policy group content

Arguments

projectId
string

Only chats filed under this project.

search
string

Words to find in the chat title or its messages. Every word must appear; case and accents are ignored.

view
string

active (default), pinned or trash.

limit
integer

How many to return. From 1 to 100. Default 40.

cursor
string

The nextCursor from the previous page. Must not be empty.

Returns: {items, nextCursor, totalCount}. Each item has chatId, title, snippet, groundingMode, projectId, pinned, createdAt, updatedAt, lastMessageAtMs, trashedAtMs and currentTurnStatus.

{"tool": "chats.list", "args": {"search": "pricing"}}

chats.get

Reads one chat and its most recent messages: your questions and the answers, with cited sources and skill names.

Read · runs with talkbar_read · MCP switch On by default · policy group content

Arguments

chatIdrequired
string

The chat, from chats.list.

limit
integer

How many of the most recent messages to return. From 1 to 200. Default 20.

beforeSequence
integer

nextBeforeSequence from the previous call, to page older messages.

Returns: The chat (as in chats.list, plus workspaceId and replyLanguage), messages, hasMoreMessages and nextBeforeSequence. Each message has messageId, role, content, createdAt, sources ([{n, label, sourceType, sourceId, sessionId, documentId, atMs, locator, snippet, href}]) and skill.

  • A chat in the Trash can still be read; its trashedAtMs is set.
{"tool": "chats.get", "args": {"chatId": "chat_12", "limit": 50}}

chats.trash.list

Lists the chats in the Trash.

Read · runs with talkbar_read · MCP switch On by default · policy group content

Arguments

limit
integer

How many to return. From 1 to 200. Default 50.

Returns: {chats: [{chatId, title, trashedAt}]}.

chats.update

Renames a chat, pins it, or files it under a project.

Write · runs with talkbar_change · MCP switch Off by default · policy group contentChanges

Arguments

chatIdrequired
string

The chat, from chats.list.

title
string

The new title. May be empty, as in the app.

pinned
boolean

true pins, false unpins.

projectId
string | null

The project, or null to take the chat out of its project.

Returns: {chatId, title, pinned, projectId}.

  • Give at least one field. A chat in the Trash is refused: restore it first.

chats.trash

Moves a chat to the Trash. It can be restored.

Write · runs with talkbar_delete · MCP switch Off by default · policy group contentChanges

Arguments

chatIdrequired
string

The chat, from chats.list.

Returns: {chatId, trashed: true}. Trashing a chat already in the Trash succeeds.

  • 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.

chats.restore

Brings a chat back from the Trash.

Write · runs with talkbar_change · MCP switch Off by default · policy group contentChanges

Arguments

chatIdrequired
string

The chat, from chats.list.

Returns: {chatId, title, pinned, projectId}. Restoring a chat that is not in the Trash returns the same answer.

documents.list

Lists the documents in a workspace.

Read · runs with talkbar_read · MCP switch On by default · policy group content

Arguments

projectId
string

Only documents filed under this project.

query
string

Case-insensitive match on the document title.

sessionId
string

Only the documents added to this session (as sessions.documents lists them).

limit
integer

How many to return. From 1 to 200. Default 50.

Returns: {documents: [{documentId, title, fileType, status, pinned, projectId, updatedAt}]}.

{"tool": "documents.list", "args": {"projectId": "proj_456"}}

documents.get

Reads one document's details and a short preview.

Read · runs with talkbar_read · MCP switch On by default · policy group content

Arguments

documentIdrequired
string

The document, from documents.list or sessions.documents.

Returns: The list row plus sizeBytes, sourceKind, indexProgress, preview and createdAt.

documents.read

Reads a document's extracted text in pages.

Read · runs with talkbar_read · MCP switch On by default · policy group content

Arguments

documentIdrequired
string

The document, from documents.list or sessions.documents.

offset
integer

nextOffset from the previous page, in characters. An offset past the end is refused.

maxChars
integer

Page size in characters. From 1,000 to 200,000. Default 20000.

Returns: {documentId, title, status, totalChars, offset, nextOffset, truncated, text}.

  • Fails with a clear message when the document has no extracted text yet, or is no longer available.
{"tool": "documents.read", "args": {"documentId": "doc_8", "maxChars": 40000}}

documents.update

Renames a document, pins it, or files it under a project.

Write · runs with talkbar_change · MCP switch Off by default · policy group contentChanges

Arguments

documentIdrequired
string

The document, from documents.list or sessions.documents.

title
string

The new title. Must not be empty.

pinned
boolean

true pins, false unpins.

projectId
string | null

The project, or null to take the document out of its project. The project must not be in the Trash.

Returns: The document's list row.

  • Give at least one field. Adding, removing and re-indexing documents stay in the app.

Related

Calendar and series

MCP and CLI operations to list, schedule, prepare, move, snooze, skip and cancel planned meetings, and to manage session series and their schedules.

Exports

MCP and CLI operations to configure export destinations and automatic export rules, and to preview, queue, run, cancel, retry and resolve session exports.