Obsidian Bonfires MCP

A hybrid MCP server that bridges Claude Desktop with both Obsidian vaults and the Bonfires platform, enabling seamless knowledge management and collaboration.

Features

Obsidian Integration

• Vault Management: List, create, and read files in your Obsidian vault
• Real-time Access: Direct integration with Obsidian's Local REST API
• File Operations: Create new notes, read existing content, navigate vault structure

Bonfires Platform Integration

• Bonfire Management: Create, join, and explore bonfires (knowledge communities)
• Community Features: Browse public bonfires, get detailed bonfire information
• Collaborative Knowledge: Share and discover knowledge within bonfire communities

Installation

npm install

Configuration

Prerequisites

1. Obsidian Local REST API Plugin: Install and configure the Local REST API plugin in Obsidian
2. Bonfires Account: Sign up for a Bonfires account and obtain your API credentials

Claude Desktop Configuration

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "obsidian-bonfires": {
      "command": "bash",
      "args": [
        "-c",
        "cd /home/thdev/os/NERDDao/obsidian-bonfires-mcp && npx ts-node src/index.ts"
      ],
      "env": {
        "BONFIRES_SAAS_ENDPOINT": "http://localhost:3000",
        "BONFIRES_API_KEY": "your-api-key",
        "BONFIRES_USER_ID": "your-user-id",
        "OBSIDIAN_API_KEY": "---",
        "OBSIDIAN_PROTOCOL": "http",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27123"
      }
    }
  }
}

Environment Variables

Bonfires Configuration

• BONFIRES_SAAS_ENDPOINT - Bonfires API endpoint (default: http://localhost:3000)
• BONFIRES_API_KEY - Your Bonfires API key for authentication
• BONFIRES_USER_ID - Your Bonfires user ID

Obsidian Configuration

• OBSIDIAN_API_KEY - API key from Obsidian Local REST API plugin
• OBSIDIAN_PROTOCOL - Protocol for Obsidian API (http/https, default: http)
• OBSIDIAN_HOST - Obsidian API host (default: 127.0.0.1)
• OBSIDIAN_PORT - Obsidian API port (default: 27123)

Available Tools

Obsidian Tools

• list-files-in-vault - Browse your vault's file structure
• create-file-in-vault - Create new notes and files
• read-file-in-vault - Read content from existing files

Bonfires Tools

• list-bonfires - Browse available bonfires with filtering options
• create-bonfire - Create new bonfire communities
• join-bonfire - Join existing bonfires
• get-bonfire-details - Get detailed information about specific bonfires

Development

npm run start  # Start the MCP server
npm run test   # Run tests

Architecture

Claude Desktop → Obsidian-Bonfires MCP Server → [Obsidian Local REST API, Bonfires Platform]

This hybrid approach enables:

1. Direct Obsidian Integration: Real-time access to your local knowledge base
2. Bonfires Community Access: Connect with shared knowledge communities
3. Unified Interface: Single MCP server for both local and collaborative knowledge management

Getting Started

1. Install the Obsidian Local REST API plugin and configure it
2. Set up your Bonfires account and obtain API credentials
3. Configure the environment variables in Claude Desktop
4. Start using both your personal Obsidian vault and collaborative Bonfires within Claude!