Show the authenticated Achi Drive user, auth method, and whether the token has file-content access.

List all teams the user is a member of, with their roles. Use the returned team IDs as the teamId arg to other tools to operate inside a team's space.

List files and folders. Omit parentFolderId for the root. Pass teamId to list inside a team. Supports cursor-based pagination via the returned nextCursor.

Get metadata for a single file (name, mimeType, sizeBytes, etc.). Does NOT return content — use read_file for that.

Get metadata for a folder.

List the immediate children (files + subfolders) of a folder.

Search files and folders by name (case-insensitive substring match). Scans up to 5,000 items per scope; results may be truncated for huge drives.

Download a file and return its content inline. Default cap: 1 MB; absolute cap: 5 MB. For larger files, pass rangeStart/rangeEnd to fetch a specific byte range. Text mime types return as text. Images return as MCP image content. Other binaries return as embedded resource.

Read a file as plain text, decoded as UTF-8. Convenience wrapper around read_file with a default 1 MB cap. Returns an error if the file is not text-encodable.

Get the JPEG thumbnail of a file (if it has one). Returns MCP image content. Useful for previewing images/videos without downloading the full file.

Upload a new file. Provide content as base64 (for binaries) or text. Set mimeType for proper handling.

Rename, move, star/unstar, trash/restore a file in one call. Pass only the fields you want to change.

Move a file to trash, or delete it permanently (irreversible). Default is trash.

Create a new folder.

Rename, move, star/unstar, trash/restore a folder.

Move a folder to trash (recursive — all descendants trashed) or delete it permanently (also recursive — all contents wiped from R2 + DB). Permanent delete is irreversible.

List Properties (Vermietung) apartments the user can see. Pass teamId for a space such as Chi Ross. scope=all lists every space.

Load one apartment: tenant, rent, address, trail folder. Does not invent Anschrift or IBAN.

Write Properties fields (squareMeters, rooms, rent, tenant, notes, …). Snapshots the current row first so restore_unit can undo a bad write. Always pass versionReason. Use ifUpdatedAt from get_unit.updatedAt to avoid clobbering.

List Properties unit snapshots (newest first). Use restore_unit if an earlier write was wrong.

Revert a Properties unit to a prior snapshot. The live row is snapshotted first so this restore can also be undone.

List the Properties document trail for an apartment (HV, heating, tax, prior NK letters).

Create a Properties trail document (NK letter, HV file, …). Send contentBase64 for the PDF/file. Use this instead of asking the user to re-attach. Uploading into Achi Properties/{unit} also creates a trail row.

Patch a trail document’s title, documentDate (YYYY-MM-DD or DD.MM.YYYY), or notes. Use this for a wrong letter date — do not ask the user to edit the UI.

Download one trail document (PDF/ODT). Use this instead of asking the user to re-attach HV or heating files.

Bank-statement payment trail for an apartment (cold/warm/NK). Source of rent-paid truth.

Stored Vermieter letterhead for a space. Empty fields stay empty — never invent legal name, street, or IBAN.

Kontoauszug lines for a team space. Requires teamId.

Mailboxes the user can read. Never returns passwords.

Search mail the user can read (subject/from/snippet). No passwords.

Read one mail message including plaintext body. No passwords.

List Drive /Agent notes in a space (agent.md, learnings/letters.md, …). Requires a content-access token.

List Drive folders that mirror a private git repo. Agents read the Drive copy — never ask for a GitHub token.

List SKILL.md files mirrored from git folders in this space (e.g. novel-dialogue). Then read_file on the fileId.

Find one mirrored skill by name (novel-dialogue) and return its Drive fileId. Use read_file next.

Compile a tenant Nebenkostenabrechnung PDF on the Achi server (no browser pdf.js). Pass recoverable line items only. Do not invent amounts, Anschrift, or IBAN. Do not include Eigentümerkosten leftovers or Quellenangabe — the server strips them. If tenants changed mid-year, pass occupancyId + periodFrom + periodTo so this letter does not overwrite the other stay. Returns a PDF. Also files the unit trail and a settlement (x-achi-nk-settlement-id).

List tenant NK settlements for an apartment and year. Mid-year move-out → two rows, not one.

Patch one NK settlement (status, amounts, notes). Does not change other tenants in the same year.