gray-matter Connector for AI agents.
1 live capability
Query your Obsidian vault and Hugo notes using structured metadata.
Waiting for input…
Why people use gray-matter
Markdown Frontmatter Harvester for Obsidian Vault Organization
This Connector changes that by creating a metadata map. Instead of your AI client wandering through your folders blindly, it gets a structured JSON index of every note's tags and status. You can just ask, 'Show me all the drafts I wrote in 2023,' and it gives you the list instantly.
What Vinkius changes
It turns your flat folder of files into a queryable database for your AI agent.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding drafts in a large blog
A blogger has 200 posts in a Hugo folder and needs to find the 5 that are still marked as 'draft' to finish them today.
- Real-world use case 02
Tag-based research discovery
A researcher wants to see every note tagged with 'biotech' and '2023' to prepare for a meeting.
- Real-world use case 03
Date-based auditing
A student wants to see how many notes they wrote in October to track their study progress.
Complete set · 1capability
The complete gray-matter capability set.
These are the exact actions your AI can choose when you ask it to work with gray-matter.
01
1 capability in this set.
Part of 1 available through gray-matter.
- 01 Capability
Harvest markdown frontmatter
Provide a folder path to scan all markdown files and extract metadata like tags and dates. This lets your AI see the structure of your entire vault at once.
Set up in minutes
One URL. Then ask gray-matter to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use gray-matter 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_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable gray-matter for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter URL.
- Step 03
Save and start
Save the connection and enable gray-matter in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"markdown-frontmatter-harvester": {
"url": "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter
Open Agent mode in chat and ask: "Using gray-matter, help me...". 1 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"markdown-frontmatter-harvester": {
"url": "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter
Ask Copilot: "Using gray-matter, help me...". 1 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"markdown-frontmatter-harvester": {
"url": "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter
Open Cascade and ask: "Using gray-matter, help me...". 1 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"markdown-frontmatter-harvester": {
"url": "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter
Ask Cline: "Using gray-matter, help me...". 1 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add markdown-frontmatter-harvester --transport http "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/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 gray-matter
Ask Claude: "Using gray-matter, show me...". 1 tools are ready
Where the request belongs
Work gray-matter can move forward.
Knowledge workers and developers who have hundreds of notes and need to find specific ones without manual searching.
Obsidian Power User
Searching for specific research tags across a 5,000-note vault on a Tuesday afternoon.
Technical Blogger
Finding all 'draft' posts in a Hugo repository that need editing before a deadline.
Research Scientist
Organizing and querying hundreds of study notes by date and status to prep for a presentation.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsObsidian Publish
Empower your AI to read your public or private Obsidian Publish sites. Index files, crawl navigation trees, and retrieve deep markdown knowledge.
Markdown Task Extractor
Instantly scan any local folder of Markdown notes (Obsidian, Notion, Logseq) and aggregate every scattered '- [ ]' to-do item into a single, structured list for your AI.
Bear
Manage your Bear notes via AI. search, create, and organize your markdown knowledge base autonomously.
Markdown Utilities Engine
Equip your AI with programmatic Markdown capabilities. Deterministically generate Table of Contents (TOC) with correct anchor links and format perfect Markdown tables from JSON.
RAG Payload Metadata Extractor
Extracts metadata, structural markers, and efficiency metrics from RAG source documents using deterministic regex patterns.
Memo Meister
Create and organize smart notes with AI-powered tagging, search, and knowledge connections that make your ideas retrievable.
Bring your own AI
Change the model, client or framework. Keep gray-matter 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 gray-matter.
The practical details behind the request, access and result.
Does the Markdown Frontmatter Harvester work with my Obsidian vault?
Yes, it's designed to scan your local Obsidian folders and pull out all the YAML metadata.
Is my data safe with the Markdown Frontmatter Harvester?
Your notes never leave your machine. The Connector scans your local files and only shares the metadata with your AI client.
Can I use this for my Hugo website?
Yes, it works great for Hugo sites by extracting the frontmatter from your blog posts.
How fast is the indexing?
It uses high-speed globbing to scan thousands of files in milliseconds.
Does it read the actual content of my notes?
No, it only looks at the YAML frontmatter at the top of your files.
Do I need to move my files to a special folder?
No, you just need to give the Connector the absolute path to your existing folder.
Does it send my entire note content to the AI?
No. To protect your privacy and save context tokens, it strictly extracts ONLY the YAML metadata block between the --- delimiters. The actual body text of your note is ignored.
Will this alter my Obsidian files?
Not at all. The parser operates in a strict read-only mode. It reads the files into memory to extract the metadata and never writes back to the disk.
Does it work with nested folders?
Yes! The engine uses recursive globbing to scan every single folder and sub-folder inside the path you provide.
One connection away
Give your agent a direct line to gray-matter.
Connect gray-matter once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available