Obsidian Publish Connector for AI agents.
5 live capabilities
Query your markdown knowledge base and published notes instantly.
Waiting for input…
Why people use Obsidian Publish
Obsidian Publish for Markdown Knowledge Management
This Connector gives your AI client a direct line to your published vault. Your agent can now browse your navigation trees and pull the exact markdown content it needs, turning your static notes into a searchable oracle.
What Vinkius changes
Your AI gets a direct path to your notes without manual copy-pasting.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Cross-referencing research notes
A researcher needs to find a specific quote in 500 notes.
- Real-world use case 02
Querying a technical digital garden
A developer wants to find deployment steps in a 'DevOps' folder.
- Real-world use case 03
Auditing internal SOP updates
A manager wants to know if the 'HR Policy' note is updated.
Complete set · 5capabilities
The complete Obsidian Publish capability set.
These are the exact actions your AI can choose when you ask it to work with Obsidian Publish.
01—03
3 capabilities in this set.
Part of 5 available through Obsidian Publish.
- 01 Capability
List files
List all the raw file paths that are currently published in your workspace. This helps your agent see the full scope of your notes.
- 02 Capability
Get file
Pull the exact text and binary assets from a specific note for your agent to read. This lets your agent access the actual content of your documents.
- 03 Capability
Site info
Show the global configuration and styling for your target Obsidian Publish endpoint. You can use this to check if your site is live and correctly mapped.
04—05
2 capabilities in this set.
Part of 5 available through Obsidian Publish.
- 04 Capability
List navigation
Display your Markdown navigation trees in a structured format for easier browsing. This helps your agent understand the folder hierarchy.
- 05 Capability
Get metadata
Grab the internal creation hashes and frontmatter properties for a specific page. It lets your agent see tags and internal links.
Set up in minutes
One URL. Then ask Obsidian Publish to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Obsidian Publish from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Obsidian Publish, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Obsidian Publish for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Obsidian Publish URL.
- Step 03
Save and start
Save the connection and enable Obsidian Publish in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"obsidian-publish": {
"url": "https://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Obsidian Publish
Open Agent mode in chat and ask: "Using Obsidian Publish, help me...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"obsidian-publish": {
"url": "https://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Obsidian Publish
Ask Copilot: "Using Obsidian Publish, help me...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"obsidian-publish": {
"url": "https://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Obsidian Publish
Open Cascade and ask: "Using Obsidian Publish, help me...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"obsidian-publish": {
"url": "https://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Obsidian Publish
Ask Cline: "Using Obsidian Publish, help me...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add obsidian-publish --transport http "https://edge.vinkius.com/vk_preview_2g0EdU9eeaIsXiKX4gDTqfxPUZ4owDXPPYajo4f3/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Obsidian Publish
Ask Claude: "Using Obsidian Publish, show me...". 5 tools are ready
Where the request belongs
Work Obsidian Publish can move forward.
Researchers who need to cross-reference dozens of notes quickly. Writers who want to query their world-building docs. Technical leads who need to turn internal SOPs into a queryable knowledge base for the team.
Technical Writer
Summarizing complex documentation sets for team onboarding.
Fiction Author
Querying character traits and plot points in a world-building vault.
Knowledge Manager
Building a chatbot that reads and summarizes team SOPs.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsMarkdown Frontmatter Harvester
Scan local Obsidian or Hugo vaults and extract all YAML frontmatter (tags, dates, status) into a single structured JSON. Let your AI query your scattered notes metadata instantly.
GitBook
Manage technical documentation via GitBook. list organizations and spaces, handle document pages, search content, and audit collections directly from any AI agent.
FlowUs
All-in-one knowledge management and collaboration platform. manage pages, blocks, and databases via AI.
Logseq (Knowledge Management)
Manage your knowledge base via Logseq. create pages, insert outliner blocks, and search across your local graph.
Fern
Manage and interact with Fern documentation platforms. generate access tokens, index websites for AI, and query analytics directly from your agent.
Wolai
All-in-one information organization and collaboration platform. manage pages, databases, and blocks via AI.
Bring your own AI
Change the model, client or framework. Keep Obsidian Publish connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Obsidian Publish.
The practical details behind the request, access and result.
Can the Obsidian Publish MCP read my private notes?
Yes, it can read your private notes as long as you provide the required access token during the setup process.
Does this Connector let my AI agent edit my notes?
No, this Connector is designed for reading and summarizing content. It does not have permissions to edit or delete your notes.
How does the Obsidian Publish MCP help with research?
It allows your agent to quickly cross-reference different notes across your vault, making it much faster to find connections between topics.
Can I use Obsidian Publish MCP for my company's SOPs?
Yes, it is a great way to turn internal standard operating procedures into a queryable knowledge base for your team.
Does the Obsidian Publish MCP support binary assets?
Yes, the get_file capability is capable of retrieving both textual content and binary assets from your published notes.
How do I connect my vault to the Obsidian Publish MCP?
Simply subscribe to the Connector and enter your Obsidian Publish Site ID in the configuration settings.
Can the AI accurately recreate the folder structure of my vault?
Yes. When the model invokes list_navigation, it downloads the systematic JSON map of the entire public vault, thereby allowing it to understand the relationships and physical structure of your folders perfectly.
Does `get_file` automatically render complex Markdown components?
No rendering is performed on our end. The get_file capability returns pure raw Markdown (including frontmatter and obsidian syntax). Fortunately, LLMs (like Claude) are exceptionally adept at reading and reasoning over raw Markdown text structures.
If my Published site is private and requires a password, does it still work?
Yes, it works gracefully. If you configured Obsidian Publish with restricted read access, you can manually inject a persistent token into the setup, giving your AI agent the clearance to read securely behind the authentication wall.
One connection away
Give your agent a direct line to Obsidian Publish.
Connect Obsidian Publish once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available