Seafile Mcp

Seafile MCP Server

MCP (Model Context Protocol) server for Seafile cloud storage. Access your self-hosted files from AI assistants like Claude, OpenCode, and other MCP clients.

Features

• List, read, and write files in your Seafile libraries
• Create and manage directories
• Move, copy, and rename files
• Search across libraries
• Supports both account-based and library-specific authentication

Installation

Using pip

pip install seafile-mcp

From source

git clone https://github.com/5p00kyy/seafile-mcp.git
cd seafile-mcp
pip install -e .

Configuration

Create a .env file or set environment variables:

Required

• SEAFILE_SERVER_URL: Your Seafile server URL

Authentication (choose one)

Option 1: Account Authentication (access all libraries)

• SEAFILE_USERNAME: Your email
• SEAFILE_PASSWORD: Your password

Option 2: Library Token (single library, more secure)

• SEAFILE_REPO_TOKEN: API token from library settings
• SEAFILE_REPO_ID: Library UUID

Optional

• SEAFILE_MAX_READ_SIZE: Max file size to read (default: 1MB)
• SEAFILE_MAX_WRITE_SIZE: Max upload size (default: 10MB)
• SEAFILE_TIMEOUT: Request timeout in seconds (default: 30)

Usage with OpenCode

Add to your OpenCode MCP configuration:

{
  "mcpServers": {
    "seafile": {
      "command": "python",
      "args": ["-m", "seafile_mcp"],
      "env": {
        "SEAFILE_SERVER_URL": "https://your-seafile.com",
        "SEAFILE_USERNAME": "user@example.com",
        "SEAFILE_PASSWORD": "your-password"
      }
    }
  }
}

Or with library token:

{
  "mcpServers": {
    "seafile": {
      "command": "seafile-mcp",
      "env": {
        "SEAFILE_SERVER_URL": "https://your-seafile.com",
        "SEAFILE_REPO_TOKEN": "your-api-token",
        "SEAFILE_REPO_ID": "library-uuid"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | seafile_list_libraries | List all accessible libraries | | seafile_get_library_info | Get library details | | seafile_list_directory | List directory contents | | seafile_read_file | Read file content | | seafile_write_file | Write text to a file | | seafile_upload_file | Upload binary file (base64) | | seafile_create_directory | Create a folder | | seafile_delete | Delete file or folder | | seafile_move | Move file or folder | | seafile_copy | Copy file or folder | | seafile_rename | Rename file or folder | | seafile_get_file_info | Get file metadata | | seafile_get_download_link | Get download URL | | seafile_search | Search files by name |

File Handling

• Text files: Content returned directly (up to MAXREADSIZE)
• Binary files: Returns metadata and download URL
• Large files: Returns download URL instead of content

Security Notes

• Use library tokens for production (limits access to single library)
• Never commit .env files with credentials
• API tokens can be revoked from Seafile web interface

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 5p00kyy
• Source: 5p00kyy/seafile-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.