Skip to content
MCP server

Seafile

Browse, search, read and organise files on a Seafile server from a Mac

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, self-hosted, CLI
Runs
Locally
Version
0.1.1
Listing updated
1 day ago

About Seafile

Seafile is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

This server lets an assistant work with a self-hosted Seafile instance, signing in through your server's own browser login page so password, SSO or two-factor all work and the assistant never sees credentials. The token is stored in the macOS Keychain.

It needs nothing installed beyond macOS 14 or later, since it runs on JavaScript for Automation with the Mac's own curl. Tools are grouped into just two, read and write, each taking an action argument, so you approve two permission prompts rather than dozens. Setting SEAFILE_READ_ONLY removes the write tool entirely, and transfers are limited to a single local folder, so a prompt-injected request to upload a private key is refused.

Writes are cautious: deletes go to the library trash, overwrites need an explicit replace flag and keep the old version, dry runs are available, and an identical write twice within 15 minutes is refused. Encrypted libraries can be listed but not read or shared.

Install

Run in a terminal

claude mcp add seafile-mcp -- npx -y https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "seafile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "seafile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "seafile-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "seafile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "seafile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb"
      ]
    }
  }
}

Configuration

  • SEAFILE_URLSeafile server address; if empty, given at the first sign-in
  • SEAFILE_LOCAL_DIRThe only local folder for downloads and uploads (default ~/Downloads)
  • SEAFILE_READ_ONLYtrue hides the write tool

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

read
Read actions: sign_in, status, list_libraries, list_folder, search, file_info, read_file, file_history, list_trash, list_share_links
write
Write actions: download_file, upload_file, write_text_file, create_folder, rename, move, copy, delete, restore, revert_file, create_share_link, delete_share_link, sign_out

What it does

Browse and search
List libraries, folders and file details and search by name.
Read text files
Reads Markdown, CSV, code and logs with paging.
Versions and trash
View file history, revert versions and restore deleted items.
Organise files
Create folders, rename, move, copy and delete to the trash.
Share links
Create links with password, expiry and upload or download rights.
Local folder limit
Transfers only use one configured local directory.

Good for

  • Ask an assistant to find a document across libraries
  • Move or rename files in bulk with a dry run first
  • Create a share link with an expiry date
  • Restore a deleted file or an earlier version

Pricing

Open source

Seafile FAQ

Does the assistant see my password?

No. Sign-in happens in your browser on your Seafile login page and only a token is kept in the Keychain.

What does it need?

macOS 14 or later and a Seafile server that allows browser sign-in for clients.

Can I make it read-only?

Yes, set SEAFILE_READ_ONLY=true to remove the write tool.

Does it work with encrypted libraries?

They can be listed, but not read, uploaded to or shared.

Is Seafile free?

Yes. Seafile is open source, so you can use and self-host it for free.

How do I add Seafile to Claude Code?

Run this command in your terminal: claude mcp add seafile-mcp -- npx -y https://github.com/ipsupport-llc/seafile-mcp/releases/download/v0.1.1/seafile-mcp.mcpb

What are the best alternatives to Seafile?

The closest alternatives to Seafile are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Seafile

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media