Connect Claude to your Obsidian vault with MCP
An Obsidian vault is a folder of Markdown files. Valutorio opens that folder as it is, and Valutorio Sync gives it a personal MCP endpoint in the cloud. Add the endpoint and your token to Claude, and Claude can search, read and write your notes. You do not install an Obsidian plugin or run a local server, and the Valutorio app does not have to be open.
The app is free. The MCP endpoint comes with Valutorio Sync, $5.99 / €5.99 a month.
What you need
- Valutorio on a Mac with macOS 14 or later. It is free on the Mac App Store.
- Your vault: any folder of Markdown files, an Obsidian vault included. Nothing is imported or converted.
- Valutorio Sync, $5.99 / €5.99 a month. It syncs the vault to Valutorio Cloud and includes the MCP endpoint and a token.
- An MCP client from the list below.
Step 1: open the vault and turn on Sync
Open Valutorio and choose your vault folder. Then choose File ▸ Vault Settings…, open the Sync tab and turn on Valutorio Sync. You can keep working while the first upload runs.
Step 2: copy the endpoint and the token
In File ▸ Vault Settings…, open the AI Access tab. It shows your endpoint,
https://sync.valutorio.com/mcp, and your token, which starts with
vmcp_. Choose Display Token to show it and copy it from there, or Copy Setup Prompt to copy the
endpoint, the token and a JSON config in one block. The token is stored in your
Keychain on this Mac.
Step 3: add Valutorio to your MCP client
Replace vmcp_… with your token in each example.
Claude Code
Run this once in Terminal:
claude mcp add --transport http valutorio https://sync.valutorio.com/mcp --header "Authorization: Bearer vmcp_…"
Then ask Claude Code about your notes, for example "search my Valutorio notes for the launch plan". claude mcp list shows the server and its status.
Cursor
Add this to ~/.cursor/mcp.json, the file that Cursor's MCP settings open:
{
"mcpServers": {
"valutorio": {
"url": "https://sync.valutorio.com/mcp",
"headers": { "Authorization": "Bearer vmcp_…" }
}
}
}
Claude Desktop
Claude Desktop connects through the small mcp-remote bridge, which needs Node.js on your Mac. Open Claude ▸ Settings ▸ Developer ▸ Edit Config and add:
{
"mcpServers": {
"valutorio": {
"command": "npx",
"args": ["mcp-remote", "https://sync.valutorio.com/mcp",
"--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer vmcp_…" }
}
}
}
Save the file and restart Claude Desktop. Valutorio appears in the list of tools.
What Claude can do with your notes
The endpoint has five tools: search notes, read a note, write a note, list notes and delete a note. Claude chooses the tool from your question. A note Claude writes is an ordinary Markdown file; it arrives in your vault on the Mac and the iPhone at the next sync, and Obsidian can open it like any other note.
Edits work the other way too. A change you make in Valutorio, or in Obsidian on the same folder, reaches Claude after Valutorio syncs the folder.
How this differs from a local Obsidian MCP server
Most Obsidian MCP servers run on your own computer. Many talk to Obsidian through a community plugin, so Obsidian has to be open and the computer has to be awake. They cost nothing, and your notes never leave the machine. If that matters most to you, a local server is the right choice.
The Valutorio endpoint runs in the cloud. It answers when your Mac is asleep, and you set it up once, with one URL and one token. The cost is the subscription, and your synced notes live on our servers.
Security and privacy
The token is a password for your notes. Anyone with the token can read and change them, so keep it out of shared files and screenshots. If a token leaks, choose Rotate Token… in the AI Access tab: the old token stops working at once and you get a new one.
Your notes are encrypted in transit and at rest. They are not end-to-end encrypted: the server must read them to answer Claude. Valutorio has no tracking and no ads, and the app works offline without Sync.
Questions
Do I have to stop using Obsidian?
No. Valutorio and Obsidian read the same plain Markdown folder. You can keep editing in Obsidian; Valutorio syncs the folder and serves it to Claude.
Does Valutorio have to be running?
Not for Claude to read or write. The endpoint answers from Valutorio Cloud. Valutorio has to run on a Mac or an iPhone to bring new local edits up to the cloud and Claude's edits down to your folder.
Which MCP clients work?
Any client that can send an Authorization header to a streamable HTTP MCP server. The three above are the setups this page shows step by step.
What does it cost?
The app is free. Valutorio Sync costs $5.99 / €5.99 a month and includes sync between Mac and iPhone and the MCP endpoint. Valutorio Pro, $13.99 / €13.99 a month, adds the built-in Assistant. Buy them in the app. The web plan gives you the web app and the MCP endpoint; the Mac and iPhone apps do not get Sync or Pro from it.
Published by the developer of Valutorio. Valutorio as an Obsidian alternative · Valutorio Sync as an Obsidian Sync alternative · What Valutorio is