# Seafile

> Seafile is an open-source MCP server for files and documents. Browse, search, read and organise files on a Seafile server from a Mac. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, self-hosted, CLI
- **Repository:** https://github.com/ipsupport-llc/seafile-mcp
- **MCP Registry name:** io.github.ipsupport-llc/seafile-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/seafile
