MCP server
Files
Every attachment the mailbox holds.
Files tools
| Tool | What it does |
|---|---|
| listFiles | Every attachment the mailbox holds, sent and received, searchable by name, filtered by kind and sorted newest, oldest, largest or by name. Returned a page at a time. |
| getFile | One file, with every download link it went out as and how often each was fetched. |
| deleteFile | Delete a file for good: its bytes go and every download link stops working. A chat always asks first. |
A file is part of the mail it came on, so reading needs threads:read and deleting needs threads:write. Somebody limited to some addresses sees only the files that arrived at them, and only the owner of the mailbox can delete one.
The tools read the file index, not the bytes. Downloading a file is GET /files/{id}/content on the REST API or files.download in the SDK.