Skip to content

Storage Provider Overview

The MCP server supports 7 storage backends for reading and writing documents. Storage tools accept provider configuration inline or via environment variables.

Provider Type Value Use Case
Local Filesystem local Development, single-server
Amazon S3 s3 AWS cloud storage, production
MinIO minio Self-hosted S3-compatible
WebDAV webdav Nextcloud, ownCloud, SharePoint
Google Drive googledrive Google Workspace
OneDrive onedrive Microsoft 365, SharePoint
SMB/CIFS smb Corporate network shares

Storage tools accept provider configuration inline:

{
"tool": "onlyoffice_storage_read",
"arguments": {
"provider": {
"type": "local",
"baseDir": "/data/documents"
},
"path": "reports/2026/january.docx"
}
}

Or configure a default provider via environment variables:

Terminal window
STORAGE_TYPE=local
STORAGE_BASE_DIR=/data/documents

Best for development and single-server deployments.

{ "type": "local", "baseDir": "/data/documents" }
Env Variable Description
STORAGE_TYPE Set to local
STORAGE_BASE_DIR Root directory path

Production-grade cloud storage with presigned URL support.

{
"type": "s3",
"bucket": "company-documents",
"region": "eu-central-1",
"accessKeyId": "AKIA...",
"secretAccessKey": "wJal..."
}
Env Variable Description
S3_BUCKET Bucket name
S3_REGION AWS region
S3_ACCESS_KEY_ID Access key ID
S3_SECRET_ACCESS_KEY Secret access key
S3_ENDPOINT Custom endpoint (for MinIO)
S3_URL_EXPIRY_SECONDS Presigned URL expiry (default: 600)

Minimum IAM policy: s3:GetObject, s3:PutObject, s3:DeleteObject, s3:ListBucket.

Self-hosted S3-compatible object storage.

{
"type": "minio",
"bucket": "documents",
"endpoint": "http://minio:9000",
"accessKeyId": "minioadmin",
"secretAccessKey": "minioadmin",
"forcePathStyle": true
}

Uses the same S3_* env variables as S3, plus S3_ENDPOINT and S3_FORCE_PATH_STYLE=true.

Connect to WebDAV-compatible servers (Nextcloud, ownCloud, SharePoint).

{ "type": "webdav", "url": "http://localhost:8080/webdav", "authType": "none" }

For OAuth2-based providers (Google Drive, OneDrive) and SMB/CIFS, detailed setup guides are available:

Google Drive

OneDrive

SMB/CIFS