consigcody94/vault-weaver

🕸️ Vault Weaver

AI-powered Obsidian knowledge management - create notes, search content, discover backlinks, and visualize your knowledge graph

🤔 The Knowledge Challenge

"My notes are scattered and disconnected"

You've built a vault of hundreds of notes, but finding connections and maintaining structure is overwhelming.

• 🔍 Manually searching through notes
• 🔗 Missing connections between topics
• 📝 Inconsistent metadata and tags
• 🗂️ Difficulty maintaining structure

Vault Weaver bridges your vault with AI - search, create, link, and visualize your knowledge through natural language.

✨ Features

🚀 Quick Start

Prerequisites

• Node.js 18+
• Obsidian vault (local folder)
• Claude Desktop

Installation

git clone https://github.com/consigcody94/vault-weaver.git
cd vault-weaver
npm install
npm run build

Configure Claude Desktop

Add to your config file:

{
  "mcpServers": {
    "vault-weaver": {
      "command": "node",
      "args": ["/absolute/path/to/vault-weaver/build/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

Finding your vault path:

Restart Claude Desktop

Completely quit and reopen Claude Desktop to load the MCP server.

💬 Usage Examples

Create Notes

"Create a meeting note for today's standup with attendees and action items"
→ Creates note with proper frontmatter, folder organization, and structure

"Add a new research note about machine learning with tags for AI and papers"
→ Creates tagged note in research folder with YAML frontmatter

Search Your Vault

"Find all my notes about machine learning"
→ Returns matching notes with relevant snippets

"Search for active projects tagged with 'priority'"
→ Filters by tag and returns project notes

Discover Connections

"What notes link to my project roadmap?"
→ Finds all backlinks with context

"Show me the knowledge graph around my 'productivity' note"
→ Generates visual connection map

Manage Metadata

"Update the status to 'completed' on my API redesign note"
→ Merges new frontmatter with existing

"Add tags 'done' and 'q1' to the feature spec"
→ Updates YAML frontmatter

🛠️ Available Tools

📊 Tool Details

create_note

Create a new markdown note in your vault.

Example with frontmatter:

{
  "title": "Meeting Notes 2024-01-15",
  "content": "# Team Sync\n\n## Attendees\n- Alice\n- Bob\n\n## Action Items\n- [ ] Review PRs",
  "folder": "meetings/2024",
  "frontmatter": {
    "tags": ["meeting", "team"],
    "date": "2024-01-15",
    "type": "meeting"
  }
}

search_notes

Search notes by content, title, tags, or folder.

get_backlinks

Find all notes that link to a specific note using [[wikilinks]].

create_graph

Generate a graph of note connections.

update_frontmatter

Update or add YAML frontmatter to an existing note.

🎯 Workflow Examples

Daily Note Workflow

1. Create today's note:

   create_note with title: "2024-01-15", folder: "daily", frontmatter: {date: "2024-01-15", type: "daily"}
   

2. Link to relevant projects:

   search_notes with query: "current sprint", tag: "active"
   

3. Check what links to yesterday:

   get_backlinks with notePath: "daily/2024-01-14.md"
   

Research Organization

1. Create research note:

   create_note with title: "ML Paper Review", folder: "research", frontmatter: {tags: ["ml", "paper"]}
   

2. Find related notes:

   search_notes with query: "neural network", limit: 10
   

3. Visualize connections:

   create_graph with rootNote: "research/ML Paper Review.md", depth: 2
   

🔗 Obsidian Compatibility

🔒 Security Notes

🐛 Troubleshooting

📋 Requirements

• Node.js 18 or higher
• Obsidian vault (local file system access)
• Read/write permissions to vault directory

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see file for details.

👤 Author

consigcody94

Weave your knowledge into a connected web.