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

Request Example

Response

Field Descriptions:
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