seafile-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@seafile-mcp search my Seafile libraries for the Q3 budget spreadsheet"
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 (Seafile MCP connector)
MCP connector for a self-hosted Seafile server (seahub). It speaks the seahub HTTP API over stdio and over stateless Streamable HTTP on localhost.
Seafile server is GPLv2. This connector is MIT. It only calls the HTTP API on the server you configure. It is not affiliated with Seafile Ltd. Bring your own account token or library API token.
seafile.routes.json is a route table derived with ast from haiwen/seahub v14.0.9-server (seahub/urls.py and seahub/api2/urls.py). It is not an official OpenAPI document, and it has no request body schemas. The connector covers all 655 routes in that table (/api2/* and /api/v2.1/*). Routes are grouped into 24 toolsets. SEAFILE_TOOLSETS selects a subset. The default set is small and read-focused. all enables every toolset, including admin.
There is no default base URL. SEAFILE_URL is required. Hosts on seafile.com, including cloud.seafile.com, are refused.
Setup
npm install
npm run ci
npm start
npm run start:httpnpm start speaks stdio. npm run start:http serves Streamable HTTP at http://127.0.0.1:3000/mcp and GET /health. HTTP mode has no authentication of its own. Keep it on localhost.
Create a token with POST /api2/auth-token/ on your server, or create a library API token in the Seafile UI. Put it in SEAFILE_TOKEN. The connector sends Authorization: Token and never prints the token. It does not store a username or password. A library API token cannot delete, move, or copy.
{
"mcpServers": {
"seafile": {
"command": "node",
"args": ["/workspace/connectors/seafile/dist/index.js"],
"env": {
"SEAFILE_URL": "http://127.0.0.1:8000",
"SEAFILE_TOKEN": "...",
"SEAFILE_ALLOW_WRITES": "false",
"SEAFILE_TOOLSETS": "server,libraries,files_and_dirs,search",
"SEAFILE_CONTACT": "you@example.com"
}
}
}
}If the file server is on another origin than SEAFILE_URL, set SEAFILE_FILE_SERVER_URL to that origin (often port 8082). read_text_file and write_text_file fetch only that origin, the SEAFILE_URL origin, or a /seafhttp path on the same host. They do not follow redirects to any other host.
Docker (HTTP, no authentication, localhost only):
docker build -t seafile-mcp .
docker run -p 3000:3000 \
-e SEAFILE_URL=http://host.docker.internal:8000 \
-e SEAFILE_TOKEN=... \
seafile-mcpDo not put the token in the image.
Regenerate the operations registry after a route-table bump:
npm run gen:operationsRelated MCP server: Syncthing MCP
Config
Variable | Meaning |
| Required. Self-hosted seahub origin. No default. |
| Account token or library API token. Sent as |
| Optional file-server origin for upload and download URLs that are not on |
| Optional, default off. Set to |
| Must be the literal |
| Comma list of toolsets, or |
| Local request budget. Default 30. |
| Upstream timeout. Default 20000. |
| GET cache TTL. Default 60. Writes clear the cache. |
| Contact token in the User-Agent. |
|
|
| HTTP port. Default 3000. |
Safety
Every non-GET route is a write. So is any GET that mints a download URL, upload URL, update URL, auth token, WebDAV secret, SSO link, or similar credential. A write needs confirm set to the boolean true and SEAFILE_ALLOW_WRITES=true. Otherwise the tool returns a dry-run preview of the method, path, query, and redacted body, and it sends nothing. The string "true" and the boolean false are rejected.
Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and the path. The same warning is in the tool description for destructive and credential actions.
read_text_file and write_text_file are extra actions on seafile_files_and_dirs. Both are gated. They stay inside one library path (absolute, no ..). Text only. 256 KiB cap. write_text_file replace defaults to false. replace: true adds an overwrite warning and names the target.
Responses are parsed as JSON objects, arrays (items), or strings (value). stack and traceback fields are dropped. Error text drops server stack traces and filesystem paths. Field names for tokens, passwords, pwd_hash, magic, and random_key are redacted. Share-link and file-server tokens in URLs are redacted. repo_id is kept.
HTTP 401 is unauthorized. HTTP 403 is forbidden. HTTP 404 is not found. HTTP 400 and 422 are invalid. HTTP 429 is rate limited and includes Retry-After. HTTP 5xx is a server error. Connection failures are network errors. Timeouts are timeouts.
/api2/ bodies are sent as form fields. /api/v2.1/ bodies are sent as JSON. Query object and body object are free-form because the route table has no schemas.
Tools
Default SEAFILE_TOOLSETS publishes 4 tools. SEAFILE_TOOLSETS=all publishes 24 tools (655 route operations, plus read_text_file and write_text_file on the files tool). Each tool takes action plus params, query, body, and confirm when the tool can write.
Toolset | Tool | Operations | Default |
server |
| 46 | yes |
libraries |
| 39 | yes |
files_and_dirs |
| 74 | yes |
search |
| 6 | yes |
history_trash |
| 24 | no |
share_links |
| 35 | no |
upload_links |
| 12 | no |
library_sharing |
| 41 | no |
groups |
| 54 | no |
tags |
| 17 | no |
starred |
| 6 | no |
notifications |
| 14 | no |
activities |
| 1 | no |
invitations |
| 6 | no |
address_book |
| 5 | no |
wikis |
| 47 | no |
via_repo_token |
| 40 | no |
ocm |
| 8 | no |
admin_users |
| 20 | no |
admin_libraries |
| 23 | no |
admin_groups |
| 14 | no |
admin_logs |
| 29 | no |
admin_shares |
| 15 | no |
admin_system |
| 79 | no |
Example. List libraries, preview a create, then confirm it.
{ "action": "list_repos" }{ "action": "create_repo", "body": { "name": "Lab" } }{ "action": "create_repo", "body": { "name": "Lab" }, "confirm": true }Read a text file after you set SEAFILE_ALLOW_WRITES=true.
{
"action": "read_text_file",
"params": { "repo_id": "REPO" },
"query": { "p": "/notes/a.txt" },
"confirm": true
}Live check
npm run live-check and npm run live-check:extra talk to a real Seafile server when SEAFILE_URL and SEAFILE_TOKEN are set (SEAFILE_FILE_SERVER_URL too, if the fileserver is on another origin). They were run against a real local Seafile 9.0.10 server: failed=0, 59 checks. See LIVE-CHECK.md for exactly what was and was not exercised. They print pass and fail lines only and never the token.
This session did not run the live check. The parent runs it against a local server.
What this is not
This is not a Seafile desktop sync client. It does not watch folders or speak the sync protocol.
This is not a client for Seafile Cloud or any seafile.com host.
This is not an official OpenAPI SDK. Body fields come from seahub view code for the common routes and are free-form everywhere else.
This connector does not keep your password, and it does not turn a library API token into an account token. POST /api2/auth-token/ is a gated credential write. Its token is redacted in the result.
Admin toolsets are off unless you set SEAFILE_TOOLSETS.
Attribution
Seafile server is GPLv2. This connector is MIT and is not a derivative of the Seafile server. It is an independent HTTP client of the seahub API.
License
MIT, see LICENSE. This is an independent, unofficial connector and is not endorsed by the Seafile project or its owners.
seafile.routes.json is a route table derived from haiwen/seahub (Apache-2.0).
Available Tools
4 toolsseafile_files_and_dirsBDestructiveIdempotent
seafile_files_and_dirs covers the files_and_dirs toolset (74 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Writes, including side-effect GETs, need confirm true and SEAFILE_ALLOW_WRITES=true. Omit confirm for a dry-run preview of method, path, and redacted body. Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and path. Actions: copy_repos_fileops: POST /api2/repos/{repo_id}/fileops/copy/. POST /api2/repos/{repo_id}/fileops/copy/ (OpCopyView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. create_related_files: POST /api/v2.1/related-files/. POST /api/v2.1/related-files/ (RelatedFilesView). Body and query are free-form. create_repos_file_comments: POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/. POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/ (FileCommentsView). Path params: repo_id, file_uuid. Body and query are free-form. create_repos_file_comments_replies: POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/. POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/ (FileCommentRepliesView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. create_repos_file_participants: POST /api/v2.1/repos/{repo_id}/file/participants/. POST /api/v2.1/repos/{repo_id}/file/participants/ (FileParticipantsView). Path params: repo_id. Body and query are free-form. delete_copy_move_task: DELETE /api/v2.1/copy-move-task/. DELETE /api/v2.1/copy-move-task/ (CopyMoveTaskView). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_dir: DELETE /api2/repos/{repo_id}/dir/. Delete a directory. Query p is the path. Destructive. Warning: destructive, exposure, or credential change. delete_file: DELETE /api2/repos/{repo_id}/file/. Delete a file into library trash. Query p is the path. Destructive. Warning: destructive, exposure, or credential change. delete_related_files: DELETE /api/v2.1/related-files/{related_id}/. DELETE /api/v2.1/related-files/{related_id}/ (RelatedFileView). Path params: related_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_batch_delete_folders_item: DELETE /api/v2.1/repos/batch-delete-folders-item/. DELETE /api/v2.1/repos/batch-delete-folders-item/ (RepoFoldersItemBatchDelete). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_batch_delete_item: DELETE /api/v2.1/repos/batch-delete-item/. DELETE /api/v2.1/repos/batch-delete-item/ (ReposBatchDeleteItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_dir: DELETE /api/v2.1/repos/{repo_id}/dir/. DELETE /api/v2.1/repos/{repo_id}/dir/ (DirView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file: DELETE /api/v2.1/repos/{repo_id}/file/. DELETE /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file_comments: DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/. DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/ (FileCommentView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file_comments_replies: DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/. DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/ (FileCommentReplyView). Path params: repo_id, file_uuid, comment_id, reply_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file_participant: DELETE /api/v2.1/repos/{repo_id}/file/participant/. DELETE /api/v2.1/repos/{repo_id}/file/participant/ (FileParticipantView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_file_detail: GET /api2/repos/{repo_id}/file/detail/. Read file detail for query p. get_file_download_link: GET /api2/repos/{repo_id}/file/. Mint a file download URL. Query p is the file path. Side-effect GET. The URL token is redacted. Warning: destructive, exposure, or credential change. get_repos_dir: GET /api/v2.1/repos/{repo_id}/dir/. GET /api/v2.1/repos/{repo_id}/dir/ (DirView). Path params: repo_id. Body and query are free-form. get_repos_dir_detail: GET /api/v2.1/repos/{repo_id}/dir/detail/. GET /api/v2.1/repos/{repo_id}/dir/detail/ (DirDetailView). Path params: repo_id. Body and query are free-form. get_repos_dir_metadata: GET /api2/repos/{repo_id}/dir/metadata/. GET /api2/repos/{repo_id}/dir/metadata/ (DirMetaDataView). Path params: repo_id. Body and query are free-form. get_repos_file: GET /api/v2.1/repos/{repo_id}/file/. GET /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_file_comments: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/ (FileCommentView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. get_repos_file_comments_replies: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/ (FileCommentReplyView). Path params: repo_id, file_uuid, comment_id, reply_id. Body and query are free-form. get_repos_file_metadata: GET /api2/repos/{repo_id}/file/metadata/. GET /api2/repos/{repo_id}/file/metadata/ (FileMetaDataView). Path params: repo_id. Body and query are free-form. get_repos_files_blks_download_link: GET /api2/repos/{repo_id}/files/{file_id}/blks/{block_id}/download-link/. GET /api2/repos/{repo_id}/files/{file_id}/blks/{block_id}/download-link/ (FileBlockDownloadLinkView). Path params: repo_id, file_id, block_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_office_suite: GET /api/v2.1/repos/{repo_id}/office-suite/. GET /api/v2.1/repos/{repo_id}/office-suite/ (OfficeSuiteConfig). Path params: repo_id. Body and query are free-form. get_repos_owa_file: GET /api2/repos/{repo_id}/owa-file/. GET /api2/repos/{repo_id}/owa-file/ (OwaFileView). Path params: repo_id. Body and query are free-form. get_repos_thumbnail: GET /api2/repos/{repo_id}/thumbnail/. GET /api2/repos/{repo_id}/thumbnail/ (ThumbnailView). Path params: repo_id. Body and query are free-form. get_repos_update_blks_link: GET /api2/repos/{repo_id}/update-blks-link/. GET /api2/repos/{repo_id}/update-blks-link/ (UpdateBlksLinkView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_upload_blks_link: GET /api2/repos/{repo_id}/upload-blks-link/. GET /api2/repos/{repo_id}/upload-blks-link/ (UploadBlksLinkView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_zip_task: GET /api/v2.1/repos/{repo_id}/zip-task/. GET /api/v2.1/repos/{repo_id}/zip-task/ (ZipTaskView). Path params: repo_id. Body and query are free-form. get_share_link_zip_task: GET /api/v2.1/share-link-zip-task/. GET /api/v2.1/share-link-zip-task/ (ShareLinkZipTaskView). Body and query are free-form. get_update_link: GET /api2/repos/{repo_id}/update-link/. Mint a file-server update URL for an existing file. Side-effect GET. Warning: destructive, exposure, or credential change. get_upload_link: GET /api2/repos/{repo_id}/upload-link/. Mint a file-server upload URL for query p. Side-effect GET. replace=1 allows overwrite. Warning: destructive, exposure, or credential change. list_dir: GET /api2/repos/{repo_id}/dir/. List a directory. Query p is the directory path. p defaults to / on the server. list_query_copy_move_progress: GET /api/v2.1/query-copy-move-progress/. GET /api/v2.1/query-copy-move-progress/ (QueryCopyMoveProgressView). Body and query are free-form. list_query_zip_progress: GET /api/v2.1/query-zip-progress/. GET /api/v2.1/query-zip-progress/ (QueryZipProgressView). Body and query are free-form. list_recent_added_files: GET /api/v2.1/recent-added-files/. GET /api/v2.1/recent-added-files/ (RecentAddedFilesView). Body and query are free-form. list_related_files: GET /api/v2.1/related-files/. GET /api/v2.1/related-files/ (RelatedFilesView). Body and query are free-form. list_repos_file_comments: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/ (FileCommentsView). Path params: repo_id, file_uuid. Body and query are free-form. list_repos_file_comments_replies: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/ (FileCommentRepliesView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. list_repos_file_participants: GET /api/v2.1/repos/{repo_id}/file/participants/. GET /api/v2.1/repos/{repo_id}/file/participants/ (FileParticipantsView). Path params: repo_id. Body and query are free-form. list_repos_file_uploaded_bytes: GET /api/v2.1/repos/{repo_id}/file-uploaded-bytes/. GET /api/v2.1/repos/{repo_id}/file-uploaded-bytes/ (RepoFileUploadedBytesView). Path params: repo_id. Body and query are free-form. list_repos_related_users: GET /api/v2.1/repos/{repo_id}/related-users/. GET /api/v2.1/repos/{repo_id}/related-users/ (RepoRelatedUsersView). Path params: repo_id. Body and query are free-form. move_repos_fileops: POST /api2/repos/{repo_id}/fileops/move/. POST /api2/repos/{repo_id}/fileops/move/ (OpMoveView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_async_batch_move_item_callback: POST /api/v2.1/async-batch-move-item/callback/. POST /api/v2.1/async-batch-move-item/callback/ (BatchMoveItemsUpdatePath). Body and query are free-form. Warning: destructive, exposure, or credential change. post_cancel_zip_task: POST /api/v2.1/cancel-zip-task/. POST /api/v2.1/cancel-zip-task/ (CancelZipTaskView). Body and query are free-form. post_copy_move_task: POST /api/v2.1/copy-move-task/. POST /api/v2.1/copy-move-task/ (CopyMoveTaskView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_dir: POST /api2/repos/{repo_id}/dir/. Create, rename, or move a directory. Query p is the path. Form operation is mkdir, rename, or move. post_file: POST /api2/repos/{repo_id}/file/. Create, rename, move, or copy a file. Query p is the path. Form operation is create, rename, move, or copy. Warning: destructive, exposure, or credential change. post_move_folder_merge: POST /api/v2.1/move-folder-merge/. POST /api/v2.1/move-folder-merge/ (MoveFolderMergeView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_async_batch_copy_item: POST /api/v2.1/repos/async-batch-copy-item/. POST /api/v2.1/repos/async-batch-copy-item/ (ReposAsyncBatchCopyItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_async_batch_move_item: POST /api/v2.1/repos/async-batch-move-item/. POST /api/v2.1/repos/async-batch-move-item/ (ReposAsyncBatchMoveItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_batch_copy_dir: POST /api/v2.1/repos/batch-copy-dir/. POST /api/v2.1/repos/batch-copy-dir/ (ReposBatchCopyDirView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_batch_copy_item: POST /api/v2.1/repos/batch-copy-item/. POST /api/v2.1/repos/batch-copy-item/ (ReposBatchCopyItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_batch_create_dir: POST /api/v2.1/repos/batch-create-dir/. POST /api/v2.1/repos/batch-create-dir/ (ReposBatchCreateDirView). Body and query are free-form. post_repos_batch_move_item: POST /api/v2.1/repos/batch-move-item/. POST /api/v2.1/repos/batch-move-item/ (ReposBatchMoveItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_dir: POST /api/v2.1/repos/{repo_id}/dir/. POST /api/v2.1/repos/{repo_id}/dir/ (DirView). Path params: repo_id. Body and query are free-form. post_repos_file: POST /api/v2.1/repos/{repo_id}/file/. POST /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_fileops_delete: POST /api2/repos/{repo_id}/fileops/delete/. POST /api2/repos/{repo_id}/fileops/delete/ (OpDeleteView). Path params: repo_id. Body and query are free-form. post_repos_image_rotate: POST /api/v2.1/repos/{repo_id}/image-rotate/. POST /api/v2.1/repos/{repo_id}/image-rotate/ (RepoImageRotateView). Path params: repo_id. Body and query are free-form. post_repos_sync_batch_copy_item: POST /api/v2.1/repos/sync-batch-copy-item/. POST /api/v2.1/repos/sync-batch-copy-item/ (ReposSyncBatchCopyItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_sync_batch_move_item: POST /api/v2.1/repos/sync-batch-move-item/. POST /api/v2.1/repos/sync-batch-move-item/ (ReposSyncBatchMoveItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_upload_blks_link: POST /api2/repos/{repo_id}/upload-blks-link/. POST /api2/repos/{repo_id}/upload-blks-link/ (UploadBlksLinkView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_zip_task: POST /api/v2.1/repos/{repo_id}/zip-task/. POST /api/v2.1/repos/{repo_id}/zip-task/ (ZipTaskView). Path params: repo_id. Body and query are free-form. post_share_link_zip_task: POST /api/v2.1/share-link-zip-task/. POST /api/v2.1/share-link-zip-task/ (ShareLinkZipTaskView). Body and query are free-form. Warning: destructive, exposure, or credential change. put_file: PUT /api2/repos/{repo_id}/file/. Lock or unlock a file. Body operation is lock or unlock. Body p is the path. Warning: destructive, exposure, or credential change. update_repos_batch_lock_file: PUT /api/v2.1/repos/{repo_id}/batch-lock-file/. PUT /api/v2.1/repos/{repo_id}/batch-lock-file/ (FileBatchLockView). Path params: repo_id. Body and query are free-form. update_repos_batch_unlock_file: PUT /api/v2.1/repos/{repo_id}/batch-unlock-file/. PUT /api/v2.1/repos/{repo_id}/batch-unlock-file/ (FileBatchUnlockView). Path params: repo_id. Body and query are free-form. update_repos_file: PUT /api/v2.1/repos/{repo_id}/file/. PUT /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. update_repos_file_comments: PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/. PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/ (FileCommentView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. update_repos_file_comments_replies: PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/. PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/ (FileCommentReplyView). Path params: repo_id, file_uuid, comment_id, reply_id. Body and query are free-form. update_repos_office_suite: PUT /api/v2.1/repos/{repo_id}/office-suite/. PUT /api/v2.1/repos/{repo_id}/office-suite/ (OfficeSuiteConfig). Path params: repo_id. Body and query are free-form. read_text_file: GET download link then fetch text. Query p is the library path. Params repo_id. Size cap 256 KiB. Text only. Gated. Warning: mints a download token. write_text_file: GET upload link then multipart POST. Query p is the library path. Body text string. Body replace defaults to false. Size cap 256 KiB. Gated. Warning: names the library id and path. replace true overwrites.
Inputs: action (required), body, query, params, +1 more.
seafile_librariesADestructiveIdempotent
seafile_libraries covers the libraries toolset (39 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Writes, including side-effect GETs, need confirm true and SEAFILE_ALLOW_WRITES=true. Omit confirm for a dry-run preview of method, path, and redacted body. Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and path. Actions: create_monitored_repos: POST /api/v2.1/monitored-repos/. POST /api/v2.1/monitored-repos/ (MonitoredRepos). Body and query are free-form. create_repo: POST /api2/repos/. Create a library. Form body field name is required. Encrypted libraries need passwd. The sync token in the response is redacted. create_repos_repo_api_tokens: POST /api/v2.1/repos/{repo_id}/repo-api-tokens/. Create a library API token. Credential-minting. Library tokens cannot delete, move, or copy. Warning: destructive, exposure, or credential change. create_repos_webhooks: POST /api/v2.1/repos/{repo_id}/webhooks/. POST /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. delete_monitored_repos: DELETE /api/v2.1/monitored-repos/{repo_id}/. DELETE /api/v2.1/monitored-repos/{repo_id}/ (MonitoredRepo). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repo: DELETE /api2/repos/{repo_id}/. Delete a library. Destructive. The preview names repo_id. Warning: destructive, exposure, or credential change. delete_repos: DELETE /api/v2.1/repos/{repo_id}/. DELETE /api/v2.1/repos/{repo_id}/ (RepoView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_repo_api_tokens: DELETE /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/. DELETE /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/ (RepoAPITokenView). Path params: repo_id, app_name. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_webhooks: DELETE /api/v2.1/repos/{repo_id}/webhooks/. DELETE /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_webhooks_repo_id_webhook_id: DELETE /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. DELETE /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_default_repo: GET /api2/default-repo/. GET /api2/default-repo/ (DefaultRepoView). Body and query are free-form. get_repo: GET /api2/repos/{repo_id}/. Read one library. get_repos: GET /api/v2.1/repos/{repo_id}/. GET /api/v2.1/repos/{repo_id}/ (RepoView). Path params: repo_id. Body and query are free-form. get_repos_auto_delete: GET /api/v2.1/repos/{repo_id}/auto-delete/. GET /api/v2.1/repos/{repo_id}/auto-delete/ (RepoAutoDeleteView). Path params: repo_id. Body and query are free-form. get_repos_download_info: GET /api2/repos/{repo_id}/download-info/. GET /api2/repos/{repo_id}/download-info/ (DownloadRepo). Path params: repo_id. Body and query are free-form. get_repos_history_limit: GET /api2/repos/{repo_id}/history-limit/. GET /api2/repos/{repo_id}/history-limit/ (RepoHistoryLimit). Path params: repo_id. Body and query are free-form. get_repos_owner: GET /api2/repos/{repo_id}/owner/. GET /api2/repos/{repo_id}/owner/ (RepoOwner). Path params: repo_id. Body and query are free-form. get_repos_public: GET /api2/repos/public/. GET /api2/repos/public/ (PubRepos). Body and query are free-form. get_repos_webhooks: GET /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. GET /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form. list_repo_tokens: GET /api2/repo-tokens/. GET /api2/repo-tokens/ (RepoTokensView). Body and query are free-form. Warning: destructive, exposure, or credential change. list_repos: GET /api2/repos/. List libraries visible to the token. list_repos_get: GET /api/v2.1/repos/. GET /api/v2.1/repos/ (ReposView). Body and query are free-form. list_repos_repo_api_tokens: GET /api/v2.1/repos/{repo_id}/repo-api-tokens/. List library API tokens. Token values are redacted. list_repos_webhooks: GET /api/v2.1/repos/{repo_id}/webhooks/. GET /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. post_default_repo: POST /api2/default-repo/. POST /api2/default-repo/ (DefaultRepoView). Body and query are free-form. post_repo: POST /api2/repos/{repo_id}/. Library password or rename. Query op is rename, setpassword, or checkpassword. Form fields repo_name and repo_desc for rename. post_repos_archive: POST /api/v2.1/repos/{repo_id}/archive/. POST /api/v2.1/repos/{repo_id}/archive/ (RepoArchiveView). Path params: repo_id. Body and query are free-form. post_repos_batch: POST /api/v2.1/repos/batch/. POST /api/v2.1/repos/batch/ (ReposBatchView). Body and query are free-form. post_repos_public: POST /api2/repos/public/. POST /api2/repos/public/ (PubRepos). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_send_new_password: POST /api/v2.1/repos/{repo_id}/send-new-password/. POST /api/v2.1/repos/{repo_id}/send-new-password/ (RepoSendNewPassword). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_set_password: POST /api/v2.1/repos/{repo_id}/set-password/. POST /api/v2.1/repos/{repo_id}/set-password/ (RepoSetPassword). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_webhooks: POST /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. POST /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form. update_repos_auto_delete: PUT /api/v2.1/repos/{repo_id}/auto-delete/. PUT /api/v2.1/repos/{repo_id}/auto-delete/ (RepoAutoDeleteView). Path params: repo_id. Body and query are free-form. update_repos_history_limit: PUT /api2/repos/{repo_id}/history-limit/. PUT /api2/repos/{repo_id}/history-limit/ (RepoHistoryLimit). Path params: repo_id. Body and query are free-form. update_repos_owner: PUT /api2/repos/{repo_id}/owner/. PUT /api2/repos/{repo_id}/owner/ (RepoOwner). Path params: repo_id. Body and query are free-form. update_repos_repo_api_tokens: PUT /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/. PUT /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/ (RepoAPITokenView). Path params: repo_id, app_name. Body and query are free-form. Warning: destructive, exposure, or credential change. update_repos_set_password: PUT /api/v2.1/repos/{repo_id}/set-password/. PUT /api/v2.1/repos/{repo_id}/set-password/ (RepoSetPassword). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. update_repos_webhooks: PUT /api/v2.1/repos/{repo_id}/webhooks/. PUT /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. update_repos_webhooks_repo_id_webhook_id: PUT /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. PUT /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form.
Inputs: action (required), body, query, params, +1 more.
seafile_searchCRead-only
seafile_search covers the search toolset (6 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Actions: get_items_search: GET /api2/items-search/. GET /api2/items-search/ (ItemsSearch). Body and query are free-form. get_published_repo_search: GET /api/v2.1/published-repo-search/. GET /api/v2.1/published-repo-search/ (PublishedRepoSearchView). Body and query are free-form. get_search_group: GET /api/v2.1/search-group/. GET /api/v2.1/search-group/ (SearchGroup). Body and query are free-form. get_search_user: GET /api2/search-user/. GET /api2/search-user/ (SearchUser). Body and query are free-form. search: GET /api2/search/. Search libraries. Query q is the text. search_file: GET /api/v2.1/search-file/. Search file names and content. Query q is the text.
Inputs: action (required), body, query, params.
seafile_serverBDestructiveIdempotent
seafile_server covers the server toolset (46 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Writes, including side-effect GETs, need confirm true and SEAFILE_ALLOW_WRITES=true. Omit confirm for a dry-run preview of method, path, and redacted body. Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and path. Actions: account_info: GET /api2/account/info/. Read the account behind SEAFILE_TOKEN. The connector does not store a password. auth_ping: GET /api2/auth/ping/. Ping with the account token. Confirms the token is accepted. create_abuse_reports: POST /api/v2.1/abuse-reports/. POST /api/v2.1/abuse-reports/ (AbuseReportsView). Body and query are free-form. create_auth_token: POST /api2/auth-token/. Mint an account token. Credential-minting write. Output token is redacted. Prefer setting SEAFILE_TOKEN outside this connector. Warning: destructive, exposure, or credential change. delete_accounts: DELETE /api2/accounts/{email}/. DELETE /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_auth_token_by_session: DELETE /api/v2.1/auth-token-by-session/. DELETE /api/v2.1/auth-token-by-session/ (AuthTokenBySession). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_devices: DELETE /api2/devices/. DELETE /api2/devices/ (DevicesView). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_two_factor_auth: DELETE /api2/two-factor-auth/{email}/. DELETE /api2/two-factor-auth/{email}/ (TwoFactorAuthView). Path params: email. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_user: DELETE /api/v2.1/user/. DELETE /api/v2.1/user/ (User). Body and query are free-form. Warning: destructive, exposure, or credential change. get_accounts: GET /api2/accounts/{email}/. GET /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. get_auth_token_by_session: GET /api/v2.1/auth-token-by-session/. GET /api/v2.1/auth-token-by-session/ (AuthTokenBySession). Body and query are free-form. Warning: destructive, exposure, or credential change. get_avatars_user_resized: GET /api2/avatars/user/{user}/resized/{size}/. GET /api2/avatars/user/{user}/resized/{size}/ (UserAvatarView). Path params: user, size. Body and query are free-form. get_client_sso_link: GET /api2/client-sso-link/. GET /api2/client-sso-link/ (ClientSSOLink). Body and query are free-form. Warning: destructive, exposure, or credential change. get_client_sso_link_token: GET /api2/client-sso-link/{token}/. GET /api2/client-sso-link/{token}/ (ClientSSOLink). Path params: token. Body and query are free-form. Warning: destructive, exposure, or credential change. get_query_io_status: GET /api/v2.1/query-io-status/. GET /api/v2.1/query-io-status/ (SeahubIOStatus). Body and query are free-form. get_subscription: GET /api/v2.1/subscription/. GET /api/v2.1/subscription/ (SubscriptionView). Body and query are free-form. get_user: GET /api/v2.1/user/. GET /api/v2.1/user/ (User). Body and query are free-form. get_user_avatar: GET /api/v2.1/user-avatar/. GET /api/v2.1/user-avatar/ (UserAvatarView). Body and query are free-form. get_webdav_secret: GET /api/v2.1/webdav-secret/. Read the WebDAV secret. Side-effect style credential read. The secret is redacted. Warning: destructive, exposure, or credential change. list_accounts: GET /api2/accounts/. GET /api2/accounts/ (Accounts). Body and query are free-form. list_devices: GET /api2/devices/. GET /api2/devices/ (DevicesView). Body and query are free-form. list_subscription_logs: GET /api/v2.1/subscription/logs/. GET /api/v2.1/subscription/logs/ (SubscriptionLogsView). Body and query are free-form. list_subscription_plans: GET /api/v2.1/subscription/plans/. GET /api/v2.1/subscription/plans/ (SubscriptionPlansView). Body and query are free-form. list_unseen_messages: GET /api2/unseen_messages/. GET /api2/unseen_messages/ (UnseenMessagesCountView). Body and query are free-form. ping: GET /api2/ping/. Ping the Seafile server. No library access. post_accounts: POST /api2/accounts/{email}/. POST /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. post_auth_token_by_session: POST /api/v2.1/auth-token-by-session/. POST /api/v2.1/auth-token-by-session/ (AuthTokenBySession). Body and query are free-form. Warning: destructive, exposure, or credential change. post_avatars_user_resized: POST /api2/avatars/user/{user}/resized/{size}/. POST /api2/avatars/user/{user}/resized/{size}/ (UserAvatarView). Path params: user, size. Body and query are free-form. post_client_login: POST /api2/client-login/. POST /api2/client-login/ (ClientLoginTokenView). Body and query are free-form. post_client_sso_link: POST /api2/client-sso-link/. POST /api2/client-sso-link/ (ClientSSOLink). Body and query are free-form. Warning: destructive, exposure, or credential change. post_client_sso_link_token: POST /api2/client-sso-link/{token}/. POST /api2/client-sso-link/{token}/ (ClientSSOLink). Path params: token. Body and query are free-form. Warning: destructive, exposure, or credential change. post_device_wiped: POST /api2/device-wiped/. POST /api2/device-wiped/ (RemoteWipeReportView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_logout_device: POST /api2/logout-device/. POST /api2/logout-device/ (LogoutDeviceView). Body and query are free-form. post_markdown_lint: POST /api/v2.1/markdown-lint/. POST /api/v2.1/markdown-lint/ (MarkdownLintView). Body and query are free-form. post_organization: POST /api2/organization/. POST /api2/organization/ (OrganizationView). Body and query are free-form. post_regdevice: POST /api2/regdevice/. POST /api2/regdevice/ (RegDevice). Body and query are free-form. post_user_avatar: POST /api/v2.1/user-avatar/. POST /api/v2.1/user-avatar/ (UserAvatarView). Body and query are free-form. post_user_convert_to_team: POST /api/v2.1/user/convert-to-team/. POST /api/v2.1/user/convert-to-team/ (UserConvertToTeamView). Body and query are free-form. post_user_list: POST /api/v2.1/user-list/. POST /api/v2.1/user-list/ (UserListView). Body and query are free-form. post_user_reset_password: POST /api/v2.1/user/reset-password/. POST /api/v2.1/user/reset-password/ (ResetPasswordView). Body and query are free-form. Warning: destructive, exposure, or credential change. server_info: GET /api2/server-info/. Read server version and feature flags. update_account_info: PUT /api2/account/info/. PUT /api2/account/info/ (AccountInfo). Body and query are free-form. update_accounts: PUT /api2/accounts/{email}/. PUT /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. update_two_factor_auth: PUT /api2/two-factor-auth/{email}/. PUT /api2/two-factor-auth/{email}/ (TwoFactorAuthView). Path params: email. Body and query are free-form. update_user: PUT /api/v2.1/user/. PUT /api/v2.1/user/ (User). Body and query are free-form. update_webdav_secret: PUT /api/v2.1/webdav-secret/. Rotate the WebDAV secret. Credential-minting. The secret is redacted. Warning: destructive, exposure, or credential change.
Inputs: action (required), body, query, params, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The four tools split the surface by domain (files/dirs, libraries, search, server), which gives an agent a rough first cut, but boundaries leak: directory and file operations appear in both seafile_files_and_dirs and seafile_libraries, and each tool is a flat bundle of dozens of raw route actions (delete_dir vs delete_repos_dir, get_repo vs get_repos, list_repos vs list_repos_get, post_repo vs update_repos_*) that are hard to tell apart without reading full path semantics. Within each tool the agent must select among 6–74 near-duplicate REST endpoints, so misselection risk is high even though the four top-level buckets are reasonably distinct.
Tool names follow a clean, predictable seafile_<domain> pattern (seafile_files_and_dirs, seafile_libraries, seafile_search, seafile_server) in consistent snake_case. However, the internal action names exposed inside each tool swing between clean task verbs (list_dir, delete_file, search_file) and raw route-derived artifacts (copy_repos_fileops, delete_repos_batch_delete_folders_item, post_repos_sync_batch_copy_item), which undermines the usability of the naming for selection.
Only four tools carry roughly 165 underlying operations (74 + 39 + 6 + 46), so the surface is massively over-compressed into mega-tools rather than scoped by user intent. The tool count is nominally small but functionally far too coarse, forcing agents to navigate huge enumerated action lists for routine operations.
Core areas — library CRUD, file/dir operations, comments, locking, batch copy/move, upload/download links, search, account and server admin — are covered, so basic workflows have no dead ends. But major Seafile domains are absent: sharing/permissions, groups, trash/recycle-bin restore, file revisions, activities/notifications, wikis, and sync, despite sharing-related zip-task endpoints being present.
Maintenance
Related MCP Connectors
Linux server administration over OAuth MCP: shell, Docker, systemd, files and monitoring.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Remote MCP server exposing SMI Aware tools, resources, and skills over Streamable HTTP.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- FlicenseCqualityDmaintenanceSchema-driven MCP server that exposes all Paperclip API operations as typed MCP tools over stdio or Streamable HTTP, supporting both authenticated and local_mode deployments.100-
- AlicenseDqualityCmaintenanceEnables secure, configurable access to one or more Syncthing instances over MCP, with read-only defaults and opt-in write, destructive, and administrative operations. Supports stdio and authenticated Streamable HTTP transports, typed tools, bounded responses, and multi-instance configuration.40MIT
- AlicenseAqualityCmaintenanceConnects MCP clients to a self-hosted photo library through its REST API, exposing assets, albums, people, search, and optional administrative toolsets with read-only defaults and confirm-gated writes. It supports stdio and localhost Streamable HTTP transports.5MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to interact with a self-hosted comic/library server through its HTTP API, exposing libraries, series, books, collections, readlists, metadata, and administrative operations with read/write safety controls over stdio or Streamable HTTP.7MIT