Stash MCP server
Commit Oct 19, 2026Lets an AI client search, read, save, and summarize structured notes from your Stash notebook.
Also known as Grafted-Software/stash-plugin, stash-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Oct 19, 2026
- License
- MIT
What is Stash MCP?
Stash lets an AI client search, read, save, and summarize structured notes from your Stash notebook.
Summary generated from the project's README
About Stash MCP server
Stash connects an AI client to your personal iPhone notebook to manage structured information. This remote MCP server allows Claude to interact with your saved links, screenshots, photos, and thoughts. Users can search through existing entries, read summarized content, or save new information directly through the chat interface. The server handles the background process of turning rough inputs into organized notes with titles, sections, and tags.
Setup requires the Stash app from the App Store and an OAuth authentication process through a sign-in page. Free users can utilize search, reading, and saving functions, though they are limited to 30 summaries and 5 research reports per month. Accessing the ask skill requires a Stash Pro subscription. The server uses tools like stash_search, stash_get, stash_create, and stash_ask to perform these actions. While notes are encrypted at rest using AES-256-GCM, the server decrypts them to process tool requests.
What you can do with it
- 1Retrieve specific saved informationAsk the AI to find specific details from your previous collections like travel plans.
- 2Capture new thoughts quicklyInstruct the client to save a new reminder or note which the server will then summarize.
- 3Query across your entire notebookUse the Pro feature to ask questions that only use your personal notes as the source of truth.
- 4Manage existing note contentUpdate or remove specific notes by providing the note name for confirmation.
Written from the project's README. Every use case is checked against a quote from it.
How to install Stash MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Stash MCP in Claude Code
$ claude mcp add --transport http stash-plugin https://stash.graftedsoftware.com/mcpInstall Stash MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"stash-plugin": {
"url": "https://stash.graftedsoftware.com/mcp"
}
}
}Install Stash MCP in VS Code
.vscode/mcp.json
{
"servers": {
"stash-plugin": {
"type": "http",
"url": "https://stash.graftedsoftware.com/mcp"
}
}
}Install Stash MCP in VS Code CLI
$ code --add-mcp '{"name":"stash-plugin","type":"http","url":"https://stash.graftedsoftware.com/mcp"}'Install Stash MCP in Codex
$ codex mcp add stash-plugin --url https://stash.graftedsoftware.com/mcpInstall Stash MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.stash-plugin] url = "https://stash.graftedsoftware.com/mcp"
Install Stash MCP in Gemini CLI
$ gemini mcp add -s user --transport http stash-plugin https://stash.graftedsoftware.com/mcpInstall Stash MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"stash-plugin": {
"url": "https://stash.graftedsoftware.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegrafted-software/stash-plugin is public and reachablegithub.com/grafted-software/stash-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-19github.com/grafted-software/stash-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubStash
Stash is an AI notebook for iPhone. Share anything into it, such as a link, a screenshot, a photo, or a rough thought, and the Stash server turns it into a structured note with a title, summary, sections, tags, and sources. This plugin lets Claude read and add to that notebook.
What you can do
- Search your notes. "Find what I saved about the Hawaii trip."
- Open a note. Claude reads the summarized note before quoting it.
- Save a note. "Stash this: renew the car registration next month." The server summarizes it once, in the background.
- Ask across your notes (Stash Pro). "What did I save about flights?" Answers come only from your notes, with no web search.
| Skill | Tools it calls |
|---|---|
search |
stash_search, stash_get |
summarize |
stash_create, stash_get |
ask |
stash_ask |
The server also exposes stash_me, stash_update, stash_delete, and stash_research. The skills only update or delete a note when you name that note and confirm.
Setup
- Get Stash from the App Store and sign in with Apple or Google.
- Install this plugin. The first time Claude calls a Stash tool, it opens a Stash sign-in page. Use the same Apple or Google account as the app.
- On the consent screen, review the scopes and select Allow.
Free accounts can search, read, and save notes. A free account gets 30 summaries and 5 research reports per month, resetting on the 1st (UTC). Ask needs Stash Pro.
What this plugin runs and sends
This plugin has no local code. It declares one remote MCP server, https://stash.graftedsoftware.com/mcp, run by Grafted Software, plus three skills written in Markdown.
- Claude sends tool calls (search queries, note text you ask it to save, note ids) to that server, authenticated with an OAuth token you grant on the consent screen.
- Notes are encrypted at rest (AES-256-GCM). They are not zero-knowledge: the server decrypts them to run tools, the same way it already does to summarize a note.
- To summarize, research, and answer questions, the server sends note text to Anthropic (Claude), via OpenRouter. Summaries and research also use OpenRouter's web search. To decide whether a summary should use web search, it sends up to 2,000 characters of the note to TypeSafe (Jev), via OpenRouter.
- Audit logs record the action, note id, and client id. They never record note bodies or search text.
To stop access, remove the connector in Claude or delete your Stash account in the app.
Privacy and support
- Privacy policy: https://stash.graftedsoftware.com/legal/privacy
- Terms: https://stash.graftedsoftware.com/legal/terms
- Agent docs: https://stash.graftedsoftware.com/agents
- Support: support@graftedsoftware.com
License
MIT. See LICENSE.
Stash MCP questions
How do I add Stash MCP to Claude Code?
Run claude mcp add --transport http stash-plugin https://stash.graftedsoftware.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Stash MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What are the limitations of a free account?
Free accounts can search, read, and save notes, but are limited to 30 summaries and 5 research reports per month. The 'Ask' feature requires Stash Pro.
Is my data encrypted?
Notes are encrypted at rest using AES-256-GCM, though they are not zero-knowledge as the server decrypts them to process tools.