Vinkius

Obsidian Publish MCP for AI Agents. Deeply Index Your Markdown Knowledge Base

Obsidian Publish MCP lets your AI agent read every note in your published markdown knowledge base. It indexes your entire site structure and pulls the raw text content of specific documents so you can summarize years of notes or cross-reference complex technical specs instantly. You get deep access to structured, private, or public writing.

Obsidian Publish MCP is compatible with Claude Claude
Obsidian Publish MCP is compatible with ChatGPT ChatGPT
Obsidian Publish MCP is compatible with Cursor Cursor
Obsidian Publish MCP is compatible with Gemini Gemini
Obsidian Publish MCP is compatible with Windsurf Windsurf
Obsidian Publish MCP is compatible with VS Code VS Code
Obsidian Publish MCP is compatible with JetBrains JetBrains
Obsidian Publish MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

Map the entire published vault structure

The MCP generates a structural map of all notes, showing how they link together in a navigable tree.

Retrieve full raw markdown content

You get the complete text and any associated assets for a specified note or file path.

Extract internal document properties

The system pulls technical data about notes, including creation dates, tags, and frontmatter fields.

Verify site deployment details

You can check the global configuration of your Obsidian Publish endpoint to confirm connectivity status.

Waiting for input…

AI Agent
Obsidian Publish

What AI agents can do with Obsidian Publish MCP: 5 Tools

These tools let your AI client perform specific actions on your site, including listing files, checking metadata, and retrieving the raw content of any note.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Obsidian Publish MCP

List Files

Lists all the file paths that have been explicitly published in your Obsidian workspace.

Get File

Retrieves the full, raw markdown text and any associated binary files for a specific...

Site Info

Checks global configuration details and styling used across your entire published...

List Navigation

Visualizes the structured, linked map of markdown notes within your vault.

Get Metadata

Extracts technical properties from a note, including tags, creation dates, and...

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Obsidian Publish MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Obsidian Publish integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on each call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Obsidian Publish, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,200+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Connections are secured and governed automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog weekly
Obsidian Publish MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Obsidian Publish. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on each call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

The pain of navigating thousands of notes Solved with Vinkius AI Gateway

You know the drill: you sit down to write something big. You need to reference that character detail from your 'Year 2' folder, cross-check a technical spec from the 'Architecture' section, and pull the official process outline from 'SOPs'. What happens? You open Obsidian, jump between dozens of tabs, copy snippets here, paste context there, and spend more time managing the source material than actually writing.

With this MCP, you stop clicking. You just tell your agent what you need. It handles the mapping process by utilizing its ability to list files and crawl navigation trees. The result? A single, synthesized answer that pulls accurate context from across your entire markdown vault.

Obsidian Publish MCP: Structured Knowledge Retrieval

Before this, gathering all the pieces involved opening multiple notes and manually tracking which file contained which piece of information. It was slow, prone to error, and required constant context switching.

Now, you connect your source and let the agent do the heavy lifting. You get structured data streams—the full content of a note via `get_file` or its technical properties using `get_metadata`. Your focus shifts entirely from file management to critical thinking.

What your AI can actually do with this

Your personal vault—the thousands of scattered markdown files across Obsidian Publish—is suddenly connected to your AI client. Instead of opening dozens of tabs and manually copy-pasting sections, your agent now sees the whole picture. It can build a functional map of your entire knowledge base by crawling the navigation structure and listing all available file paths.

Need to summarize one specific document? You just ask for it, and the raw text streams directly into your chat window. This capability means you don't have to navigate complex local folders; you talk about your notes like they're in a database. Connecting this MCP through Vinkius gives your agent access to deep file content, technical metadata, and even site configuration details—all so you can finally build that smart chatbot or research assistant based on your own work.

Built · Hosted · Managed by Vinkius Obsidian Publish - Index Markdown Files with AI
Server ID 019d75e1-e432-734c-9236-0c91927db387
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Questions you might have

How does Obsidian Publish MCP handle private vaults? +

You must provide your Obsidian Publish Site ID and an optional access token for the agent to read notes in private or restricted corporate vaults. This keeps your data secure.

Can Obsidian Publish MCP index code snippets? +

Yes. The get_file tool retrieves the full raw markdown content, which includes any markdown-fenced code blocks and technical code examples housed in your notes.

Is this only for published sites? +

No, it connects to your established Obsidian Publish environment. The MCP indexes files that are already structured within the publishing framework.

What is the difference between list_files and list_navigation? +

List files gives a simple directory of every available file path. List navigation provides a visual, linked map showing how those notes relate to each other structurally within your vault.

Does Obsidian Publish MCP only read markdown? +

It reads the raw markdown content and can retrieve associated binary assets that are embedded or referenced in your published notes.