Documentation

Accept an email-bound LotsNotes invitation.

Cancel a pending invitation.

Create shared organization-wide text or checklist knowledge.

Email a secure LotsNotes team invitation.

List organization invitations.

List organization-wide shared knowledge titles. Private notes are never returned.

Move a note between organization knowledge and projects in the same organization.

Send a fresh invitation link.

Rename or describe a LotsNotes project.

Change a member role and project access.

Add a content block to a note. For checklist blocks, ideally provide items with id, text, and checked fields. However, the API is forgiving - if you send just [{text: "task"}] or even ["task1", "task2"], it will auto-generate unique IDs and set checked=false. Example: {items: [{text: "Task 1"}, {text: "Task 2"}]}

Add a new item to an existing checklist block. The item will be added at the end of the list, unchecked.

Delete a content block from a note. This permanently removes the block.

Remove a specific item from a checklist block.

Get all content blocks for a note, ordered by position. This returns the full content of a note broken down into its component blocks.

Change the order of blocks within a note. Provide an array of block IDs with their new positions.

Update a block's content or position. For checklist blocks, ideally provide items with id, text, and checked fields. However, the API is forgiving - missing id/checked will be auto-filled.

Check or uncheck a specific item in a checklist block. Use this to mark tasks as complete or incomplete.

Attach a label to a note for organization. A note can have multiple labels.

Add multiple labels to a note at once. Skips labels that are already attached.

Create a new label for organizing notes. Labels can have a name and optional color. Label names must be unique per user.

Delete a label. This will also remove the label from all notes that have it.

Get a single label by ID.

Get all labels attached to a specific note.

Get all notes that have a specific label attached. Useful for viewing notes in a category.

List all labels for the user. Labels are sorted alphabetically by name. Supports search and pagination.

Remove a label from a note.

Replace all labels on a note with a new set. Removes existing labels and adds the specified ones.

Update a label's name or color. Name must remain unique among user's labels.

Add an existing LotsNotes user to an organization.

Create a project in a LotsNotes organization. Owner or admin required.

Create a project-visible freeform text or checklist note.

Create the authenticated user's default LotsNotes organization and project when needed.

Get one project-visible note with its text or checklist blocks. Private notes return not found.

List active LotsNotes organization members.

List inherited organization knowledge and project-specific shared note titles. Private notes are never returned.

List accessible projects in a LotsNotes organization.

Remove a member from a LotsNotes organization.

Update the title or note type of a project-visible note. Use update_block for its content.

Archive a note without deleting it.

Create a folder in a workspace, for a product, client, brand, agent or anything else. Set parent_folder_id to create it inside another folder.

Create a space inside an organization. A space can represent a product, project, brand, client, department, or initiative.

Create a shared note with a Markdown body and/or checklist items. Omit folder_id for a workspace-wide note. Title it AGENTS.md for instructions every agent should read. The response includes the note's url: give it to the person so they can open and review the note on lotsnotes.com.

Create an organization as the top-level business and team boundary.

Create a workspace for a business, team or area of work.

Delete a folder that has no subfolders. Its notes are hidden and preserved, and restore_folder brings everything back.

Recoverably delete a space. Its notes are hidden and preserved; they are never moved into broader organization knowledge.

Revoke one connection. The app's token stops working immediately.

Find shared notes by title. Workspace-wide notes always come back (as workspace_notes). With folder_id, that folder's own notes come back too (as folder_notes). Each note has a summary and a url. Read a note with read_note. A note titled AGENTS.md holds instructions for agents: read it first.

Create or update labeled notes from a client's existing context documents. Idempotent on import_key.

List the apps this person has authorized to reach their notes.

List the folders in a workspace with their paths (e.g. "Agents / Blog / Drafts") and parent_folder_id.

List active spaces for products, projects, brands, clients, departments, or initiatives.

List saved versions of an accessible note, newest first.

List the organizations whose business context this user can access.

List the workspaces you can access. A workspace holds workspace-wide notes and folders.

Soft-delete a note so it can be restored later.

Move a folder inside another folder of the same workspace. Omit parent_folder_id (or send null) to move it to the top level.

Move a note to another folder, or to another workspace (needs admin access in both). Omit folder_id to make it workspace-wide. The note keeps its id, url and version history.

Read one accessible shared note. Returns content_markdown, structured checklist items and the note's url (share it when the person wants to open the note). Private notes always return not found.

Read a saved version snapshot for an accessible note.

Rename a folder or change its description.

Rename an organization without changing its stable ID.

Rename a workspace. Its id does not change.

Assemble the core context for a bound scope into two prompt slots, plus a catalogue of the other notes available on demand.

Restore an archived or trashed note.

Restore a deleted folder and its notes.

Restore a recoverably deleted space and its preserved notes.

Restore an accessible note to a saved version while preserving the current state in history.

Save a note title, Markdown body, or checklist in one coherent operation and create one version snapshot. The response includes the note's url: give it to the person so they can open and review the change on lotsnotes.com.

Rename or describe a knowledge space.

Archive a note to remove it from the main view while keeping it accessible. Archived notes are automatically unpinned. Use list_notes with is_archived=true to view archived notes.

Fetch multiple notes with blocks by IDs in one request.

Change the background color of a note for visual organization. Set to null to remove color.

Create a new note with optional content blocks. For checklist notes, ideally provide items with id, text, and checked fields. However, the API is forgiving - if you send just [{text: "task"}] or even ["task1", "task2"], it will auto-generate unique IDs and set checked=false. Example: {block_type: "checklist", data: {items: [{text: "Buy groceries"}, {text: "Call mom"}]}}

Move a note to trash (soft delete). The note can be restored later using restore_note or permanently deleted using permanently_delete_note.

Create a copy of an existing note including all its blocks and labels. The new note will have "(Copy)" appended to its title and will not be pinned.

Permanently delete all notes in the trash. This action cannot be undone. All associated data (blocks, labels, reminders, versions) will be deleted.

Get a single note by ID. Returns the note metadata without blocks. Use get_note_with_blocks for full content.

Get a note with all its content blocks and optionally labels. This is the recommended way to read a note's full content. Blocks are returned in position order.

List all notes in the trash (soft-deleted notes). These notes can be restored using restore_note or permanently deleted.

List all notes for the user with powerful filtering options. Filter by archived status, pinned status, label, note type, or color. Search notes by title. Results are sorted with pinned notes first, then by the specified sort field. Supports pagination for large collections.

List notes with blocks (and optional labels) in a single request.

Permanently delete a note and all its associated data (blocks, labels, reminders, versions). This action cannot be undone. Use with caution.

Pin a note to the top of the list for quick access. Pinned notes always appear before unpinned notes when listing. Cannot pin archived notes.

Restore a note from archive or trash back to active status. Works for both archived notes and soft-deleted (trashed) notes.

Remove the pin from a note so it returns to normal sorting order.

Update a note's metadata including title, type, color, and pinned status. This does not modify blocks - use block-specific tools for content changes.

Cancel an active reminder without deleting it.

Set a reminder for a note. The reminder will trigger at the specified time. Supports recurring reminders with repeat rules (daily, weekly, monthly, yearly).

Delete a reminder permanently.

Get all active reminders that are past their scheduled time. These need attention.

Get details of a specific reminder including the associated note information.

Get all reminders associated with a specific note.

Get active reminders scheduled within the next N hours (default 24). Useful for showing what's coming up soon.

List all reminders for the user. Filter by note, status, or date range. Sorted by reminder time.

Mark a reminder as completed/done.

Reschedule a reminder to a later time. The reminder will be reactivated at the new time.

Update a reminder's time, repeat rule, timezone, or status.

Compare two versions of a note to see what changed between them.

Get the most recent saved version of a note.

Get a specific version including its full snapshot data.

List all saved versions of a note. Versions are sorted newest first.

Restore a note to a previous version. The current state is automatically saved as a new version before restoring, allowing you to undo the restore if needed.

Create a version snapshot of the note's current state. Useful before making significant changes to enable undo.

Create an attachment record for a file that has been uploaded to storage. The actual file upload should be done separately. Attachments can be linked to a specific block or to the note directly.

Delete an attachment record. Returns the storage path so the actual file can be deleted from storage separately.

Get details of a specific attachment including metadata.

Get the user's total storage usage across all attachments. Shows total size in bytes and MB, file counts by type.

List all attachments for a note. Can filter by block or file type.

Show the caller's LotsNotes plan (Free or Pro), where Pro comes from, the Free limits (1 organization, 3 spaces, no team members) and current use.

Start a checkout for LotsNotes Pro ($99 once: unlimited organizations, spaces and team members). Returns a link for the person to pay in their browser. Pro is already included with Pro or Business plans of LotsSocial, LotsBlog or LotsTeam.

Website endpoint: put a folder inside another folder or at the top level.