1. Navigate to NextCloud Settings
`
NextCloud → Settings → Security → App passwords
`

2. Create New App Password
- Enter name: MCP Server
- Click "Create new app password"
- Copy the generated password: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx

3. Why App Passwords?
- ✅ Limited scope and permissions
- ✅ Can be revoked independently
- ✅ No access to your main account
- ✅ Auditable access logs

Add to your claude_desktop_config.json:

`json
{
"mcpServers": {
"nextcloud": {
"command": "nextcloud-mcp-server",
"env": {
"NEXTCLOUD_URL": "https://your-nextcloud-server.com",
"NEXTCLOUD_USERNAME": "your-username",
"NEXTCLOUD_PASSWORD": "your-app-password"
}
}
}
}
`

`bash


Run the MCP server

`json
{
"name": "list-files",
"arguments": {
"path": "/Documents"
}
}
`

Response: Returns array of files with metadata (name, size, type, modification date)

`json
{
"name": "upload-file",
"arguments": {
"remotePath": "/documents/report.pdf",
"content": "JVBERi0xLjQK..." // base64 encoded content
}
}
`

`json
{
"name": "move-file",
"arguments": {
"sourcePath": "/old-location/document.pdf",
"destinationPath": "/new-location/document.pdf",
"overwrite": false
}
}
`

Response: Confirmation message with source and destination paths

`json
{
"name": "copy-file",
"arguments": {
"sourcePath": "/Documents/template.docx",
"destinationPath": "/Projects/new-document.docx",
"overwrite": true
}
}
`

Response: Confirmation message with copy operation details

`json
{
"name": "search-files",
"arguments": {
"query": "quarterly report",
"path": "/Documents",
"limit": 20,
"type": "file"
}
}
`

Response: Array of matching files with full metadata

Type Options: file, directory, all

`json
{
"name": "get-file-versions",
"arguments": {
"path": "/Documents/important-document.pdf"
}
}
`

Response: Array of file versions with timestamps, sizes, and user information

`json
{
"name": "restore-file-version",
"arguments": {
"path": "/Documents/important-document.pdf",
"versionId": "1672531200"
}
}
`

Response: Confirmation of version restoration

`json
{
"name": "create-share",
"arguments": {
"path": "/Documents/presentation.pptx",
"shareType": 3,
"password": "secure123",
"expireDate": "2024-12-31",
"note": "Shared for team review"
}
}
`

Share Types:
- 0 - User share
- 1 - Group share
- 3 - Public link
- 4 - Email share

`bash


Clone and install

Project Structure:
`
src/
├── index.ts # Main MCP server
├── services/
│ └── nextcloud.ts # NextCloud API client
├── types.ts # TypeScript definitions
└── utils/ # Utility functions

__tests__/ # Test suites
build/ # Compiled output
`

1. 🍴 Fork the repository
2. 🌿 Create your feature branch
`bash
git checkout -b feature/amazing-feature
`
3. 💻 Make your changes
4. ✅ Add tests for new features
5. 🧪 Run the test suite
`bash
npm run test
npm run lint
`
6. 📝 Commit your changes
`bash
git commit -m "✨ Add amazing feature"
`
7. 🚀 Push to your branch
`bash
git push origin feature/amazing-feature
``
8. 🔄 Open a Pull Request

$3

$3

$3

$3