Skip to main content

​
Overview

The get_share_link tool retrieves the public share link for a note. A share link lets someone open a meeting note without signing in. Available Tool:
  • get_share_link - Retrieve the current share link for a note (read-only)
Creating and deleting share links is not available over MCP. Those write actions need the mcp:notes:write scope, which the MCP server does not expose yet. Create or delete share links with the REST API instead — PUT / DELETE /v1/external/notes/{noteGuid}/share-link.
Primary Use Cases:
  • Check whether a note already has a public share link
  • Retrieve the share URL for a note to pass it along
  • Unlock a password-protected link’s details by supplying the password
Retrieves the current share link information for a note. Accepts either the share UUID (new format) or the note GUID (legacy). When the link is password-protected, pass password to verify access and unlock the full response. Required Scope: mcp:notes:read

​
Parameters

ParameterTypeRequiredDescription
noteGuidstringYesThe note GUID or share ID (UUID or noteGuid)
passwordstringNoPassword to verify if the share link is password-protected

​
Request Example

{
  "noteGuid": "abc123-def456-ghi789",
  "password": "xK9mP2qL"
}

​
Response

{
  "shareId": "9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "noteGuid": "abc123-def456-ghi789",
  "shareUrl": "https://tiro.ooo/share-links/9b2f7c1a-1234-4d56-9abc-1234567890ab",
  "hasPassword": true,
  "passwordVerified": true,
  "sharePassword": null
}
Field Descriptions:
FieldTypeDescription
shareIdstringUUID token for the share link
noteGuidstringThe original note GUID
shareUrlstringThe public URL for accessing the shared note
hasPasswordbooleanWhether the link is password-protected
passwordVerifiedbooleanPresent and true when a correct password was provided
requiresPasswordVerificationbooleanPresent and true when the link is password-protected and no password was supplied
sharePasswordstring | nullAlways null in responses (the password is never echoed back)
If the link is password-protected and you call get_share_link without a password, the response includes requiresPasswordVerification: true and omits the verification flag. Supplying the wrong password returns 401 Unauthorized.

​
Common Errors

​
Note Not Found

Solution: Verify the noteGuid is correct. Use search_notes to find valid note identifiers. Solution: The note does not have a share link yet. Create one in the Tiro app or with the REST API (PUT /v1/external/notes/{noteGuid}/share-link).

​
Best Practices