List shares
Shares you created, with type, permissions, password and expiry flags.
MCP tool nextcloud_read → list_shares
read
Lists the shares of your account, optionally for one file or folder and its contents. Each share has its type (link, user, group or email), the permissions you gave, whether it has a password and its expiry date. A public link returns its URL. Pass share_id from here to remove_share.
Parameters
| Name | Type | Description |
|---|---|---|
| path string | string | Only shares of this file or folder. |
| include_subfiles boolean | boolean | With a folder path, also shares of what is inside it. Default: false. |
| type enum | enum | all, link, user, group or email. Default: all. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nextcloud_read",
"arguments": {
"operation": "list_shares",
"arguments": {
"path": "/Clients",
"include_subfiles": true,
"type": "link"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"shares": [
{
"share_id": "412",
"path": "/Clients/Acme/proposal-q3.pdf",
"type": "link",
"url": "https://cloud.example.com/s/Qm4Zr8LcVt1NxWe",
"permissions": "read",
"password_protected": false,
"expires": null,
"created_at": "2026-06-02T10:11:00Z"
},
{
"share_id": "455",
"path": "/Clients/Brightly/brief.docx",
"type": "link",
"url": "https://cloud.example.com/s/Hd7Pb2YaUs5GkTi",
"permissions": "read",
"password_protected": true,
"expires": "2026-12-01",
"created_at": "2026-10-09T08:40:00Z"
}
]
},
"isError": false
}