📌Overview

Purpose: To provide a robust server solution for seamless interaction with Obsidian vaults, enhancing user experience and functionality.

Overview: The Claudesidian MCP Server is designed for users of varying expertise to facilitate easy management and access to notes within an Obsidian vault. It streamlines the server setup process, enabling users to quickly get organized and utilize advanced features for note-taking and web scraping.

Key Features:

Reasoning Tool: Assists in managing reasoning schemas for complex problem-solving, enhancing cognitive workflows.
CreateMemory Tool: Stores significant interactions as memories, allowing users to retain important information over time.
FuzzySearch Tool: Facilitates quick and efficient searches within the vault, making it easier to find relevant notes.
ScrapeWebsite Tool: Enables users to scrape and archive web content into their vault as notes, expanding their resources.
CreateNote Tool: Provides functionality for creating new notes directly within the Obsidian vault.
EditNote Tool: Allows users to edit existing notes, ensuring that information can be updated as needed.
MemoryRetrieval Tool: Synthesizes memories from the vault based on user queries, aiding in knowledge recall.
Relationships Tool: Manages connections between notes and entities, enhancing contextual understanding and organization.

Claudesidian MCP Server

Introduction

Welcome to the Claudesidian MCP Server! This project enables seamless interaction with your Obsidian vault through a robust server setup. Follow these step-by-step instructions to get the server up and running.

Prerequisites

Ensure you have the following installed:

Python 3.9+
Git
Playwright (for web scraping capabilities)

Installation Steps

Clone the Repository via Your IDE

Open your IDE (e.g., Visual Studio Code) and clone the repository:
- Open VS Code.
- Click on the Source Control icon.
- Click Clone Repository.
- Enter the repository URL: https://github.com/Synaptic-Labs-AI/claudesidian.git.
- Choose a local directory.
- Open the project folder in VS Code.

Configure claude_desktop_config.json

Update the file with your Obsidian vault path:

{
  "mcpServers": {
    "claudesidian": {
      "command": "claudesidian",
      "args": [
        "PATH_TO_YOUR_OBSIDIAN_VAULT"
      ]
    }
  }
}

Replace PATH_TO_YOUR_OBSIDIAN_VAULT with your vault directory.

Install Dependencies

Run the following commands in your terminal:
```
pip install -e .
```
```
playwright install
```
Run the Server
```
claudesidian "PATH_TO_YOUR_OBSIDIAN_VAULT"
```
Replace PATH_TO_YOUR_OBSIDIAN_VAULT with your vault directory.

Available Tools

Reasoning Tool: Guides complex problem-solving processes.
CreateMemory Tool: Stores important information as memories after interactions.
FuzzySearch Tool: Performs fuzzy searches to find relevant notes quickly.
ScrapeWebsite Tool: Scrapes authorized web content and archives it as notes.
CreateNote Tool: Creates new notes within your vault.
EditNote Tool: Edits existing notes.
MemoryRetrieval Tool: Retrieves and synthesizes memories based on queries.
Relationships Tool: Manages relationships between notes or entities.

Troubleshooting

Ensure your terminal is opened in the correct project directory.
Verify your vault path is correct and accessible.
Confirm Python is in your system PATH.
Run claudesidian --version to verify installation.
Check the Claude Desktop logs at C:/Users/<YourUsername>/AppData/Roaming/Claude/logs for error messages.

Contributions

We welcome community contributions:

QA Testing: Help identify bugs and improve stability.
Enhancements: Suggest or implement new features.
Feedback: Leave comments in the discussion section to guide future development.