Share Links

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. The only tool available is get_share_link, which retrieves the current share link for a note (read-only).

MCP tools for creating and deleting share links are not available yet. Create or delete share links with the REST API instead — PUT / DELETE /v1/external/notes/{noteGuid}/share-link (requires the note:write scope).

When to use

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

get_share_link

Retrieves the current share link information for a note. The noteGuid field accepts only the legacy note GUID — passing a UUID-format share ID in that field is rejected with a 400 UUID_SHARE_ID_UNSUPPORTED error. For a modern share link that uses a UUID token, pass the whole address as url instead of extracting the value. When the link is password-protected, pass password to verify access and unlock the full response. Required Scope: mcp:note:read

Parameters

Parameter	Type	Required	Description
`noteGuid`	string	Conditional	The note GUID (as returned by `list_notes` / `search_notes`). This field does not accept UUID-format share IDs — pass such links as `url`.
`url`	string	Conditional	A Tiro note URL used instead of `noteGuid` — a share link (`https://tiro.ooo/s/{shareId}`) or a note web URL (`/n/{noteId}`). Send exactly one of `noteGuid` or `url`.
`password`	string	No	Password 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:

Field	Type	Description
`shareId`	string	UUID token for the share link
`noteGuid`	string	The original note GUID
`shareUrl`	string	The public URL for accessing the shared note
`hasPassword`	boolean	Whether the link is password-protected
`passwordVerified`	boolean	Present and `true` when a correct `password` was provided
`requiresPasswordVerification`	boolean	Present and `true` when the link is password-protected and no `password` was supplied
`sharePassword`	string \| null	Always `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

Both cases — the note doesn’t exist, or the note exists but has no share link yet — return the same NOT_FOUND code (the backend doesn’t distinguish the cause). Solution: Verify the noteGuid with search_notes. If the noteGuid is correct and you still see this error, the note doesn’t have a share link yet — create one in the Tiro app or with the REST API (PUT /v1/external/notes/{noteGuid}/share-link). Solution: Pass the full share link address as url, or pass the note GUID returned by list_notes / search_notes as noteGuid.

Best Practices

Unlock password-protected links

When a link is password-protected, pass password to get_share_link to unlock the full response. Without it, the response sets requiresPasswordVerification: true.

Home

Getting Started

API

Voice File

Webhooks

MCP

CLI

Developer Resources

Overview

get_share_link

Parameters

Request Example

Response

Common Errors

Best Practices

​Overview

​get_share_link

​Parameters

​Request Example

​Response

​Common Errors

​Note or Share Link Not Found

​UUID-format share ID not supported

​Best Practices

Overview

get_share_link

Parameters

Request Example

Response

Common Errors

Note or Share Link Not Found

UUID-format share ID not supported

Best Practices