How do I use Seafile MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Seafile MCP Server Search for 'project-plan.md' across all my libraries" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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 MAX_READ_SIZE)
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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Seafile MCP Server

Seafile MCP Server

Features

Installation

Using pip

From source

Configuration

Required

Authentication (choose one)

Optional

Usage with OpenCode

Available Tools

File Handling

Security Notes

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API