1. Conduid
  2. Security
  3. Obsidianmcp
MCP server · Security

Obsidianmcp

· github.com/Manex142/ObsidianMCP

A Model Context Protocol server for secure integration with Obsidian vaults

Unclaimed mcpobsidianmodel-context-protocolai
InstallView source
37Low

Scored 4 months ago · breakdown

About Obsidianmcp

Obsidianmcp is an MCP server in the Security category: a Model Context Protocol server for secure integration with Obsidian vaults. It has been installed 0 times through Conduid.

Install

Claude Code
claude mcp add obsidianmcp -- npx -y @manex/obsidianmcp
npx
npx -y @manex/obsidianmcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Obsidianmcp

Powered by Claude · Grounded in docs

I know everything about Obsidianmcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • ·Scoped permissionsNot checked yet.

README

ObsidianMCP

A lightweight, secure Model Context Protocol (MCP) server for seamless Obsidian vault integration with AI assistants and automation tools.

Interact with your Obsidian vault through MCP-compatible clients like Claude Desktop, VSCode, or any other MCP-enabled application.

Features

  • List notes - Browse your entire vault structure with folder hierarchy
  • Read notes - Access note content securely
  • Create notes - Add new notes with initial content
  • Append content - Extend existing notes
  • Delete notes - Remove notes safely
  • Search - Find notes by name or content
  • Health checks - Monitor server status and vault accessibility

Perfect for integrating Obsidian with AI agents, building automations, and creating advanced workflows.

Available Tools

Tool Description Parameters
check_health Check server health and vault accessibility. —
list_notes List all markdown notes with folder hierarchy. —
read_note Read the content of a specific note. note: Note path (e.g., Personal/Diary.md)
create_note Create a new note. Fails if it already exists. note: Note pathcontent: Initial content (optional)
append_to_note Append content to an existing note. note: Note pathcontent: Text to append
delete_note Delete a note. This action is irreversible. note: Note path
search_notes Search notes by name or content. query: Search textsearchContent: Also search content (optional, default: false)

Quick Start

Just add this to your MCP client configuration:

Claude Code

Edit ~/.claude.json:

{
  "mcpServers": {
    "obsidian": {
      "type": "stdio",
      "command": "npx",
      "args": ["@manex/obsidianmcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "~/Documents/ObsidianVault"
      }
    }
  }
}

VSCode (Copilot)

Edit ~/.config/Code/User/mcp.json:

{
  "servers": {
    "obsidian": {
      "type": "stdio",
      "command": "npx",
      "args": ["@manex/obsidianmcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "~/Documents/ObsidianVault",
      },
    },
  },
}

Replace ~/Documents/ObsidianVault with your actual Obsidian vault path. You can use ~ for the home directory.

Note: OBSIDIAN_VAULT_PATH must point to an existing Obsidian vault directory.

Development

Requirements

  • Node.js v18+ (or Bun v1.0+ for development build)
  • Obsidian vault (local directory)

Available Scripts

Command Description
bun run dev Run server in development mode
bun run build Build for production
bun run start Run the compiled server
bun test Run test suite
bun test --watch Run tests in watch mode
bun run typecheck Type check with TypeScript
bun run inspector Run MCP inspector for debugging

Project Structure

src/
├── server.ts          # MCP server entry point
├── config/            # Configuration & environment validation
├── errors/            # Typed error classes
├── schemas/           # Zod input validation schemas
├── tools/             # MCP tool implementations
├── types/             # TypeScript type definitions
└── utils/             # File system & security utilities

Security

Built with security as a first-class concern:

  • Path traversal prevention - Validates all paths against vault boundaries
  • Symlink escape detection - Prevents breaking out via symbolic links
  • DoS protection - Limits recursion depth and result counts
  • TOCTOU prevention - Atomic file operations for safe concurrent access
  • Input validation - All inputs validated with Zod schemas

License

MIT

Support

Found a bug or have a feature request? Open an issue.

Built with Bun and Model Context Protocol SDK

README mirrored from the source repository 4 months ago. The original is authoritative.

Questions

About Obsidianmcp

How do I install Obsidianmcp?

Run claude mcp add obsidianmcp -- npx -y @manex/obsidianmcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Obsidianmcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Obsidianmcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.