Pinto Notes
Server Details
Search, read and edit your notes in Pinto Notes: folders, checklists, tables and trackers.
- Status
- Healthy
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- pinto-notes/pinto-notes
- GitHub Stars
- 16
TDQS
Score is being calculated.
Available Tools
27 toolsappend_to_noteAdd to a noteInspect
Adds markdown to the end of a note, or to the end (or start) of the section under a heading. Good for logs, lists and journals.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| text | Yes | Markdown to add. | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| at_start | No | Add at the start of the note/section instead of the end. | |
| under_heading | No | Heading text whose section gets the text. |
create_folderCreate a folderIdempotentInspect
Creates a folder; use a path like "Work/Clients" to nest it.
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Folder path. |
create_noteCreate a noteInspect
Creates a note from markdown. The first line becomes the title (write it as plain text or '# Title').
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Markdown. First line is the title. | |
| folder | No | Folder name or path. Created if it doesn't exist. Default: Notes. | |
| pinned | No | Pin it. |
create_sub_noteCreate a sub-noteInspect
Creates a note that lives inside another note: it's linked from the parent (a Title line added at the end, or under a heading) and doesn't show in the main list.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| body | Yes | Markdown for the sub-note. First line is its title. | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| under_heading | No | Put the link under this heading in the parent. |
delete_folderDelete a folderDestructiveInspect
Deletes a folder and its sub-folders. Their notes (and those notes' sub-notes) go to Recently Deleted, and each can be brought back with restore_note within 30 days; the folders themselves are not restored.
| Name | Required | Description | Default |
|---|---|---|---|
| folder | Yes | Name or path. |
delete_noteDelete a noteDestructiveInspect
Moves a note and its sub-notes to Recently Deleted. This can be undone: restore_note brings it back within 30 days.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| title | No | Note title, if you don't have the id. Must match one note. |
delete_table_rowDelete a rowDestructiveInspect
Removes the row for a date (trackers) or at a 0-based row index from a table.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| date | No | yyyy-mm-dd. | |
| index | No | 0-based row index. | |
| table | No | Which table, counting from 0. Default: the first tracker, else the first table. | |
| title | No | Note title, if you don't have the id. Must match one note. |
edit_noteEdit a noteDestructiveInspect
Precise edits: each old_text must match the note exactly once (copy it from read_note) and is replaced by new_text. Edits apply in order. Fails without changing anything if one doesn't match.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| edits | Yes | ||
| title | No | Note title, if you don't have the id. Must match one note. | |
| expected_version | No | Version from read_note; the edit fails if the note changed since. |
fetchFetchRead-onlyIdempotentInspect
Fetch an Amber Notes note by id (from search) as its full markdown, with folder, pinned state and last edit time.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Note id. |
get_fileGet a fileRead-onlyIdempotentInspect
A file's details and its contents: text files (CSV, JSON, markdown…) as text, images as an image, PDFs and other files as an attached resource. Files over 8 MB can only be opened in Amber Notes.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | File id from list_files or a pane-file: link in a note. |
get_overviewOverview of the notesRead-onlyIdempotentInspect
An overview of the person's Amber Notes: folders with counts, pinned notes and the most recently edited notes.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_filesList filesRead-onlyIdempotentInspect
Files kept in Amber Notes (PDFs, spreadsheets, images…), newest first, with the notes that embed them.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Default 30. | |
| query | No | Filter by filename. |
list_foldersList foldersRead-onlyIdempotentInspect
All folders as paths like "Work/Q4 planning", with how many notes each shows in the app.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_notesList notesRead-onlyIdempotentInspect
List notes, newest first, optionally in one folder. Use for browsing; use search_notes to find something.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Default updated. | |
| limit | No | Default 30, max 200. | |
| folder | No | Folder name or path like "Work/Q4 planning". Omit for all notes. | |
| offset | No | For paging. | |
| pinned_only | No | Only pinned notes. | |
| recently_deleted | No | List notes in Recently Deleted instead. | |
| include_sub_notes | No | Also list sub-notes (notes that live inside another note). Default false, like the app's list. |
log_table_rowLog a rowDestructiveInspect
Adds a row to a table. In a tracker with a date column it updates that date's row if there is one (the date defaults to today). Values are checked against each column's type: scales must be in range, choices one of the options, Yes/No also takes true/false.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| table | No | Which table in the note, counting every table from 0. Default: the first tracker, else the first table. | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| values | Yes | Column name → value. Omitted columns stay as they are (or empty for a new row). |
move_noteMove a noteDestructiveIdempotentInspect
Moves a note to another folder, creating the folder if it doesn't exist. Use a path like "Work/Clients" to nest.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| folder | Yes | Folder name or path. |
note_historyNote historyRead-onlyIdempotentInspect
Earlier versions of a note, newest first, with who changed it (app or an AI client).
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| limit | No | Default 10. | |
| title | No | Note title, if you don't have the id. Must match one note. |
pin_notePin or unpinDestructiveIdempotentInspect
Pins a note to the top of the list, or unpins it. Pinned state shows as pinned in every note listing.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| pinned | Yes | true to pin. |
read_noteRead a noteRead-onlyIdempotentInspect
Returns a note's markdown with its folder, dates, version and outline. For long notes, read a line range; set line_numbers to see where headings are.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| end_line | No | Last line, inclusive. | |
| start_line | No | First line, 1-based. | |
| line_numbers | No | Prefix each line with its number. |
read_tableRead a tableRead-onlyIdempotentInspect
Reads a table in a note: its columns (with types and allowed values for trackers) and its rows as objects. Use before logging so you use the right column names and values.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| last | No | Only the last N rows. | |
| table | No | Which table in the note, counting every table from 0. Default: the first tracker, else the first table. | |
| title | No | Note title, if you don't have the id. Must match one note. |
rename_folderRename a folderDestructiveIdempotentInspect
Renames a folder in place. Its notes and sub-folders stay inside it.
| Name | Required | Description | Default |
|---|---|---|---|
| folder | Yes | Current name or path. | |
| new_name | Yes | New name. |
replace_note_bodyRewrite a noteDestructiveInspect
Replaces the whole note with new markdown. Use only for full rewrites; prefer edit_note. The person sees the change in Amber Notes with Undo, and the old version stays in history.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| body | Yes | The complete new markdown. | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| expected_version | No | Version from read_note, to avoid overwriting newer changes. |
restore_noteRestore a deleted noteIdempotentInspect
Brings a note (and its sub-notes) back from Recently Deleted.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Note id. |
restore_revisionRestore an earlier versionDestructiveInspect
Puts an earlier version (from note_history) back as the note's body. The current body is kept in history too.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| revision_id | Yes | Revision id from note_history. |
searchSearchRead-onlyIdempotentInspect
Search the person's Amber Notes by words or phrases. Returns note ids and titles; read one with fetch. Locked notes are left out.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query. |
search_notesSearch notesRead-onlyIdempotentInspect
Full-text search across titles and bodies. Returns ranked notes with a highlighted snippet («match»). Locked notes are left out.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results, default 10. | |
| query | Yes | Words or a phrase. Supports "quoted phrases", OR and -exclusions. |
set_checklist_itemTick a checklist itemDestructiveIdempotentInspect
Checks or unchecks a '- [ ] item' line, matched by its text.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Note id (preferred). | |
| item | Yes | The item's text (or a unique part of it). | |
| title | No | Note title, if you don't have the id. Must match one note. | |
| checked | Yes | true to check, false to uncheck. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
27 tool updates
- First observed
append_to_note - First observed
create_folder - First observed
create_note - First observed
create_sub_note - First observed
delete_folder - First observed
delete_note - First observed
delete_table_row - First observed
edit_note - First observed
fetch - First observed
get_file - First observed
get_overview - First observed
list_files - First observed
list_folders - First observed
list_notes - First observed
log_table_row - First observed
move_note - First observed
note_history - First observed
pin_note - First observed
read_note - First observed
read_table - First observed
rename_folder - First observed
replace_note_body - First observed
restore_note - First observed
restore_revision - First observed
search - First observed
search_notes - First observed
set_checklist_item
Publisher details
- Operator
- Emil Wagman, the developer of Pinto Notes · Publisher source
- Operator website
- https://pintonotes.com
- Vendor relationship
- First-party
- Documentation
- https://pintonotes.com/blog/mcp-server
- Trust center
- https://pintonotes.com/privacy-security
- Restrictions
- Free. Needs a Pinto Notes account, which is created in the app.
Related MCP Connectors
Search, read and edit your notes in Pinto Notes (formerly Amber Notes): checklists and tables.
Create, read, search, and organize your Drafto notes and notebooks.
- Dexi NotesOAuthnet.dexi
Search and manage your Dexi notes: full-text and semantic search, tags, folders, spaced repetition.
- SumibakoOAuthcom.sumibako
Write pages into your notes vault, search them, and publish one as a shareable link.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables to create notebooks and notes with tags, and perform full-text search across notes using FTS5 syntax, all stored locally in SQLite.-
- AlicenseAqualityDmaintenanceEnables creating, managing, and searching Markdown notes with support for tags, timestamps, and full-text search. Includes AI prompts for analyzing and summarizing notes.61MIT
- FlicenseNot gradedqualityCmaintenanceEnables saving and searching local notes, with tools to list notes and search backup files.-
- AlicenseNot gradedqualityCmaintenanceSearch and read the web pages, highlights and notes you saved with the Markpin Chrome extension, kept as local Markdown files (Obsidian vault or Google Drive). Read-only by default; optional write tools ask for confirmation.1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.