---
title: "Files"
description: "Every attachment the mailbox holds."
url: "https://openemail.uk/docs/mcp/tools/files"
area: "MCP server"
category: "Tools"
---

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