Note Tracking tools

Every tool in this module, with its full description, parameters, and return value. All of them require the module to be active first. See the Note Tracking overview for how to turn it on.

CRUD

Core tools

Create, read, update, and delete entries. Every module has exactly these four.

note_tracking_add_entry

Save a note to the user's Note Tracking module. Requires the module to be active — see create_database.

Parameters

Name	Type	Required	Notes
title	string	No	Short title or label for the note.
content	string	Yes	The body of the note.
tags	string	No	Space- or comma-separated tags for organizing the note, e.g. 'work idea'.
pinned	boolean	No	Whether to pin this note so it surfaces first. Defaults to false.

Returns

The created entry as JSON, including its id.

note_tracking_list_entries

List entries in the user's active Note Tracking module, pinned notes first, then newest first.

Parameters

Name	Type	Required	Notes
limit	number	No	Max entries to return (default 100, max 500).

Returns

Every entry in the active database, pinned then newest first, as a JSON array.

note_tracking_update_entry

Update fields on an existing Note Tracking entry.

Parameters

Name	Type	Required	Notes
entryId	string	Yes	ID of the Note Tracking entry to update.
title	string	No	Short title or label for the note.
content	string	No	The body of the note.
tags	string	No	Space- or comma-separated tags for organizing the note, e.g. 'work idea'.
pinned	boolean	No	Whether to pin this note so it surfaces first.

Returns

The updated or deleted entry as JSON. Returns an error if entryId does not belong to an entry in the active database.

note_tracking_delete_entry

Delete an entry from the user's active Note Tracking module.

Parameters

Name	Type	Required	Notes
entryId	string	Yes	ID of the Note Tracking entry to delete.

Returns

The updated or deleted entry as JSON. Returns an error if entryId does not belong to an entry in the active database.

Specialized

Purpose-built tools

Shortcuts and queries shaped around how Note Tracking is actually used, so your agent doesn't have to fetch every entry and filter them itself.

note_tracking_attach_photo

Attach a photo to an existing Note Tracking entry (replacing any photo already on it). If you have the image's raw bytes, pass photo_base64. If the user attached the image in a chat client (e.g. claude.ai), you cannot read its bytes: call this WITHOUT photo_base64 to get a one-time upload link, and give that link to the user so they can upload the photo themselves. The link expires in 30 minutes. Photos are stored privately; the returned viewPath is only viewable signed into the connacto web app as this user.

Parameters

Name	Type	Required	Notes
entryId	string	Yes	ID of the Note Tracking entry to attach the photo to.
photo_base64	string	No	The photo, base64-encoded (no data: URI prefix). Omit when you cannot read the image bytes — the tool then returns an upload link for the user instead.
photo_content_type	image/jpeg \| image/png \| image/webp \| image/heic	No	MIME type of the photo, if photo_base64 is set. Defaults to image/jpeg.

Returns

JSON with a private viewPath when photo_base64 was given, or an uploadUrl to hand the user when it was not.

note_tracking_search_notes

Search the user's active Note Tracking module for notes whose title, content, or tags contain the given text (case-insensitive).

Parameters

Name	Type	Required	Notes
query	string	Yes	Text to search for in the note's title, content, or tags.
limit	number	No	Max entries to return (default 100, max 500).

Returns

Matching entries, pinned then newest first, as a JSON array.