Supstack MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
supstack-mcp
An MCP server for Supstack. It gives Claude (or any MCP client) the notes, notebooks and tasks of a Supstack vault: it can read and search them, write notes, file them into notebooks, and add, schedule and close tasks.
The server works on the vault folder itself, with the same rules as the app: the same frontmatter, the same task grammar, deletes go to .trash. The app does not have to be running; if it is, it picks the changes up as it does any change on disk.
Set up
You need Node.js 20 or newer and the path of your vault folder (the one with cards/ in it).
Claude Code
claude mcp add supstack -- npx -y github:RuslanGagushin/supstack-mcp "/path/to/vault"Claude Desktop — add to claude_desktop_config.json (Settings › Developer › Edit Config):
{
"mcpServers": {
"supstack": {
"command": "npx",
"args": ["-y", "github:RuslanGagushin/supstack-mcp", "/path/to/vault"]
}
}
}Any other MCP client: run npx -y github:RuslanGagushin/supstack-mcp <vault folder> as a stdio server.
Options:
| Leave out every tool that changes the vault |
| The vault folder, when it is not given as an argument |
Related MCP server: vault-mcp
Tools
Tool | What it does |
| Today's date, the top-level notebooks, the tags, and how many tasks are open, overdue and due today |
| The notes in a notebook, in the app's order, any number of levels down |
| A note's Markdown, its notebooks, the notes inside it and the notes that link to it |
| Notes with every word of a query, with |
| Tasks by state, note, notebook, tag, priority, or due date |
| The agenda day by day: scheduled tasks, deadlines, overdue items, repeating tasks, events |
| The daily note of a day, created if it is not there |
| A new note, in notebooks, with tags and an icon; the notebook's template is applied |
| Replace pieces of a note's text, append to it or to a section, or replace it all |
| Move a note between notebooks, set its tags and icon |
| The manual order of a notebook's notes |
| Rename a note and update the links to it |
| Delete a note, keeping a copy in |
| Add a task, to today's daily note by default, with dates, priority and tags |
| Change a task's state, dates, priority, title or tags; closing writes |
Dates are read as the app's date prompt reads them: 2026-11-20, 2026-11-20 14:00, tomorrow, fri, +3d, with an optional repeater (+1w, ++1m, .+3d) or deadline warning (-2d).
Good to know
Sync. The server never runs git. Changes it makes go out with the app's next sync.
A note open in the app. If you are editing a note in Supstack while the server changes the same note, the app's next save can overwrite the change. Leave the editor (Done) first.
Android. The server needs the vault as a folder on the computer it runs on, so it works with the desktop vault, or a clone of the vault's git repository.
Pins and saved views that point at a renamed note are not updated: they are kept in the app's settings, which the server does not touch.
Files in hidden folders (
.trash,.supstack,.git) are never read or listed.
Develop
npm installnpm testsrc/core/ holds the parts taken from the app (web/src/js/core/): frontmatter, links, search ranking, and the task grammar with its agenda. When the app changes those, bring the change over. src/vault.js is the vault on disk, src/server.js the tools.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Notes, files, GitHub, and Drive through one MCP connection.
Notes, files, GitHub, and Drive through one MCP connection.
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes an Obsidian notes vault as MCP services, enabling AI assistants to search, read, create, update, and delete notes and folders.23 npm1MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP clients to search, read, list, and append to markdown notes in a local Obsidian vault or folder of .md files.-
- AlicenseAqualityBmaintenanceEnables MCP clients to read, write, search, and manage notes, canvases, kanban boards, and other Obsidian vault content over a network, without requiring the Obsidian desktop app.33MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to search, read, create, and link notes in a local-first Markdown vault, with indexing, backlinks, and safe writes underneath.MIT