Skip to content

feat(mcp): add folder tools, a folder filter and several tags - #342

Merged
gamosoft merged 1 commit into
gamosoft:mainfrom
juanlb:feat/mcp-folder-tools-and-filters
Nov 13, 2026
Merged

gamosoft merged 1 commit into
gamosoft:mainfrom
juanlb:feat/mcp-folder-tools-and-filters

Conversation

@juanlb

@juanlb juanlb commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

Closes #337

This is the single PR you asked for in #337.

Changes

  • list_folders: lists folders, including empty ones, with note and subfolder counts.
  • move_folder: moves or renames a folder.
  • delete_folder: deletes an empty folder. It refuses the vault root and any folder with something in it. It uses a new optional require_empty parameter on DELETE /api/folders/{path}.
  • list_notes and search_notes: optional folder and recursive parameters. The filter matches whole path segments, so work does not return workspace. It runs before pagination.
  • get_notes_by_tag: optional tags and match (all or any). tag works as before.
  • move_note and move_folder: other notes do not change. The result lists the notes whose path links no longer work. It uses a new optional reportBrokenLinks field on the move endpoints.

No frontmatter in the list calls.

Calls that exist today keep working the same way. documentation/MCP.md and documentation/API.md are updated.

How I tested it

I ran the app on a test vault and called each tool through the MCP server. I also checked that the existing REST calls return the same responses as before.

- list_folders: list folders, including empty ones, with note and subfolder counts.
- move_folder: move or rename a folder.
- delete_folder: delete an empty folder. It refuses the vault root and any
  folder with something in it, through a new require_empty parameter on
  DELETE /api/folders/{path}.
- list_notes and search_notes: optional folder and recursive parameters.
  The filter matches whole path segments and runs before pagination.
- get_notes_by_tag: optional tags and match (all or any). tag works as before.
- move_note and move_folder: other notes do not change. The result lists the
  notes whose path links no longer work, through a new reportBrokenLinks
  option on the move endpoints.

Calls that exist today keep working the same way.

Refs gamosoft#337
@gamosoft
gamosoft merged commit 234e7a2 into gamosoft:main Nov 13, 2026
@gamosoft

Copy link
Copy Markdown
Owner

Thanks a lot @juanlb , this will make its way into the next release (probably next week)
🙏🙏🙏

@juanlb
juanlb deleted the feat/mcp-folder-tools-and-filters branch November 13, 2026 17:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

MCP improvements for working with folders, and links when a note moves

2 participants