MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Unofficial MCP server for the Filester (filester.me) API: uploads, files, folders, account.
Originaltext des Herstellers
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 0/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 12/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Filester (unofficial). Folge https://mcp.popnx.com/i/coltonbearden-filester-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 18. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Filester (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Filester (unofficial) für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "filester": { "command": "npx", "args": [ "-y", "filester-mcp" ], "env": { "FILESTER_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FILESTER_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Filester (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
SettingsDeveloperEdit Config
{
"mcpServers": {
"filester": {
"command": "npx",
"args": [
"-y",
"filester-mcp"
],
"env": {
"FILESTER_API_KEY": "your-value"
}
}
}
}Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Filester (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Filester (unofficial) nutzt, oder ein Werkzeug von Filester (unofficial) in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Filester (unofficial) noch nicht verbinden
Filester (unofficial) läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Filester (unofficial) verbinden kann
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Filester (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Filester (unofficial) für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user filester --env FILESTER_API_KEY=your-value -- npx -y filester-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FILESTER_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Filester (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user filester --env FILESTER_API_KEY=your-value -- npx -y filester-mcpErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Filester (unofficial) sollte in der Liste als verbunden erscheinen
Nutze Filester (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Filester (unofficial) nutzt, oder ein Werkzeug von Filester (unofficial) in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Filester (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Filester (unofficial) für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "filester": { "command": "npx", "args": [ "-y", "filester-mcp" ], "env": { "FILESTER_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FILESTER_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Filester (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
In den Einstellungen von Filester (unofficial) ist FILESTER_API_KEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Filester (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Filester (unofficial) nutzt, oder ein Werkzeug von Filester (unofficial) in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Filester (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Filester (unofficial) für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "filester": { "type": "stdio", "command": "npx", "args": [ "-y", "filester-mcp" ], "env": { "FILESTER_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FILESTER_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Filester (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
VS Code fragt nach einer Bestätigung; klicke Install
In den Einstellungen von Filester (unofficial) ist FILESTER_API_KEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Filester (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Filester (unofficial) nutzt, oder ein Werkzeug von Filester (unofficial) in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Claude Code
claude mcp add --scope user filester --env FILESTER_API_KEY=your-value -- npx -y filester-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"filester": {
"command": "npx",
"args": [
"-y",
"filester-mcp"
],
"env": {
"FILESTER_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"filester": {
"command": "npx",
"args": [
"-y",
"filester-mcp"
],
"env": {
"FILESTER_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"filester": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"filester-mcp"
],
"env": {
"FILESTER_API_KEY": "your-value"
}
}
}
}FILESTER_API_KEY geheim erforderlich envBeschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
npm: filester-mcpBasierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto coltonbearden bestätigt, dem das Repo gehört
Code zuletzt geändert: vorgestern
Nutzt MIT
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Keine Einträge auf OSV.dev für filester-mcp@0.2.0
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 18. Nov. 2026
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/coltonbearden-filester-mcp)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Das musst du eintragen: FILESTER_API_KEY
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (0.2.0) kam vorgestern in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Dieser Filester (unofficial) | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert |
| Braucht Schlüssel | Ja | Nein | Nein | Ja | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Ja | Nein |
| Basisprüfungen | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Lizenz | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
An MCP server and a command-line tool for the whole Filester file-hosting API. Upload files (streamed, up to the API's 10 GB), organise them in folders, move and delete them, and read file details and account usage, from Claude, Cursor, VS Code or any other MCP client, or from a shell script.
Unofficial. This project is not made by, endorsed by or affiliated with Filester. It is for filester.me,
not for other services that share the name (filester.net, filester.app and others). It talks to Filester's public
REST API with your own key.
429 waits out Retry-After and tries again, and the rate-limit headers are passed back.Sign in at filester.me and copy the API key from your Account Settings page. Treat it like a password: generating a new key cancels the old one at once.
You need Node.js 20 or newer. Each install line below runs the latest version from npm. Replace your-key with your key, or leave the key out to use guest uploads only.
claude mcp add filester --scope user -e FILESTER_API_KEY=your-key -- npx -y filester-mcp
The one-click way: download filester-mcp- .mcpb from the latest release and open it. Claude Desktop shows an install dialog and asks for your key.
Or add this to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": { "filester": { "command": "npx", "args": ["-y", "filester-mcp"], "env": { "FILESTER_API_KEY": "your-key" } } } }
Add to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):
{
"mcpServers": { "filester": { "command": "npx", "args": ["-y", "filester-mcp"], "env": { "FILESTER_API_KEY": "your-key" } } } }
Add to .vscode/mcp.json. VS Code asks for the key once and stores it for you:
{
"inputs": [ { "type": "promptString", "id": "filester-key", "description": "Filester API key", "password": true } ], "servers": { "filester": { "type": "stdio", "command": "npx", "args": ["-y", "filester-mcp"], "env": { "FILESTER_API_KEY": "${input:filester-key}" } } } }
The command is npx -y filester-mcp, which serves MCP over stdio. The key goes in the environment as FILESTER_API_KEY.
For a client that connects to a URL instead of starting a command:
npx -y filester-mcp --http # http://127.0.0.1:8723/mcp (--port to change it)
Authorization: Bearer . Otherwise the server's FILESTER_API_KEY is used, if it has one.Host or Origin isn't local. That's deliberate. The upload tools read paths on the machine the server runs on, so a server other machines could reach would let them upload its files.| Variable | What it does |
|---|---|
FILESTER_API_KEY | Your API key. Without it, only guest uploads and health work, and every other tool says it needs a key. |
FILESTER_API_KEY_FILE | A file that holds the key, read when FILESTER_API_KEY isn't set. The flag --api-key-file does the same. On Linux and macOS it warns if the file can be read by other users. |
FILESTER_BASE_URL | The API's address, if Filester ever moves it. Default https://u1.filester.me. |
FILESTER_MAX_RETRY_WAIT | How many seconds one call may spend waiting out 429s before it returns the 429 to you. Default 300. |
Each tool returns the API's JSON body exactly as sent, as text and as structured content. When the API sends rate-limit headers (it does on uploads), they come back too, as a second block {"rate_limit": {...}}. An API error comes back marked as an error, with its HTTP status and body.
| Tool | What it does | Example arguments |
|---|---|---|
upload_file | Upload a local file (streamed). Returns url, slug, file_id. Without a key, or with guest: true, it's an anonymous upload. | {"path": "/home/me/video.mp4", "folder": "a1b2c3d4e5f6g7h8"} |
get_upload_status | Processing status of an upload. Needs no key. | {"slug": "aBcDeFg"} |
list_files | Your files, a page at a time. Filter by folder (or "root") or by name. | {"per_page": 50, "search": "invoice"} |
get_file | One file's details, views and downloads, by slug, UUID or numeric id. | {"id": "aBcDeFg"} |
move_file | Move a file into a folder, or back to the top level. | {"file": "aBcDeFg", "folder": "root"} |
move_files | Move up to 200 files at once. Each result is reported separately. | {"files": ["aBcDeFg", "xYzAbCd"], "folder": "a1b2c3d4e5f6g7h8"} |
delete_files | Delete files for good. | {"identifiers": ["aBcDeFg"]} |
list_folders | Every folder, with parent, to rebuild the tree. | {} |
create_folder | A folder or subfolder, public (default) or private, optionally with a password. | {"name": "Episodes", "parent": "a1b2c3d4e5f6g7h8", "public": false} |
list_folder_files | The files in one folder. | {"identifier": "a1b2c3d4e5f6g7h8"} |
set_folder_thumbnail | Upload an image (JPG, PNG, GIF or WebP, up to 5 MB) as a folder's cover. | {"folder": "a1b2c3d4e5f6g7h8", "path": "./cover.jpg"} |
move_folder | Move a folder and everything in it under another parent. | {"folder": "9f8e7d6c5b4a3210", "parent": "root"} |
move_folders | Move up to 200 folders at once. | {"folders": ["9f8e7d6c5b4a3210"], "parent": "a1b2c3d4e5f6g7h8"} |
delete_folders | Delete folders and the files directly in them. Subfolders move to the top level. | {"identifiers": ["a1b2c3d4e5f6g7h8"]} |
get_account | Storage used and limit, file and folder counts, API requests today. | {} |
health | Whether the API is up. Needs no key. | {} |
These limits are Filester's own; this server adds none of its own.
https://filester.me/d/ (the url field). Files in a private folder aren't reachable there (403).docs/api-notes.md has what this project found when it tested the live API, dated, including the cases the docs leave open.
Uploads stream from disk, so file size doesn't change the server's memory: in testing, a 1 GiB upload peaked at 131 MiB of resident memory, against 119 MiB for a 50 MiB one.
MCP_TOOL_TIMEOUT (milliseconds).filester upload big.mkv.The same package installs a filester command over the same client, for scripts, cron jobs and tools like n8n:
npx -p filester-mcp filester health
export FILESTER_API_KEY=your-key filester upload ./report.pdf --folder a1b2c3d4e5f6g7h8 filester files --per-page 100 --search report --json | jq '.data[].url' echo 'secret' | filester create-folder Private --private --password-stdin filester delete-files aBcDeFg xYzAbCd
--json prints the body exactly as it came, for scripts.0 done, 1 the API answered with an error, 2 usage, 3 needs a key, 4 couldn't reach the API or read a file.filester --help lists every command.upload_file and set_folder_thumbnail read a path on the machine the server runs on. Anything that can call the tools can upload any file that user can read. Run the server only for clients you trust.npm ci
npm run build # dist/ npm test # unit tests against a local fake of the API (no network) npm run test:slow # an upload the fake reads for over 5 minutes FILESTER_API_KEY=… npm run test:live # the live suite, in a folder of its own, deleted afterwards npm run lint && npm run typecheck
main. See docs/RELEASING.md.MIT. "Filester" is the name of its owners' service, and this project uses it only to say what it works with.