{"_id":"@istrejo/obsidian-mcp","name":"@istrejo/obsidian-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@istrejo/obsidian-mcp","version":"1.0.0","description":"MCP server for Obsidian vaults via direct filesystem access. Works with Claude Desktop and Claude Code.","type":"module","bin":{"obsidian-mcp":"dist/index.js"},"scripts":{"build":"tsc && chmod 755 dist/index.js","dev":"tsx src/index.ts","test":"vitest run --coverage","test:watch":"vitest","lint":"eslint src","format":"prettier --write \"src/**/*.ts\"","typecheck":"tsc --noEmit","prepublishOnly":"npm run build && npm test","changelog":"conventional-changelog -p angular -i CHANGELOG.md -s"},"keywords":["mcp","model-context-protocol","obsidian","claude","claude-code","claude-desktop","notes","knowledge-management","ai"],"author":{"name":"José Alejandro Trejo Rivera","email":"istrejo2106@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/istrejo/obsidian-mcp.git"},"bugs":{"url":"https://github.com/istrejo/obsidian-mcp/issues"},"homepage":"https://github.com/istrejo/obsidian-mcp#readme","engines":{"node":">=20"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","fast-glob":"^3.3.3","gray-matter":"^4.0.3","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.6.0","@typescript-eslint/eslint-plugin":"^8.32.0","@typescript-eslint/parser":"^8.32.0","@vitest/coverage-v8":"^3.1.3","conventional-changelog-cli":"^5.0.0","eslint":"^9.26.0","prettier":"^3.5.3","tsx":"^4.19.4","typescript":"^5.8.3","vitest":"^3.1.3"},"gitHead":"bbbe714c9be1626c5bc098c51bbc908b8e43fc4d","_id":"@istrejo/obsidian-mcp@1.0.0","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-cNj2ucDwdAoUIcZVyuU2so6DK4LR7raSYrKadQ1Nm0jkYrlqU4UaLRqFUbakaCDc36cmd2c7FfzSJ+q5HwZc3Q==","shasum":"48248c7ea91fde0e987890938561ca7add9d92c9","tarball":"https://registry.npmjs.org/@istrejo/obsidian-mcp/-/obsidian-mcp-1.0.0.tgz","fileCount":99,"unpackedSize":110870,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHzr3hB/OytH1GHavr7YqKVF+uBvbN6JCt72YPUU7zFtAiEAhRDsJC8ow0yD02yeezuzoE4SQvtV3BoUrIE3uOdswG4="}]},"_npmUser":{"name":"and1tech","email":"istrejo2106@gmail.com"},"directories":{},"maintainers":[{"name":"and1tech","email":"istrejo2106@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/obsidian-mcp_1.0.0_1776985354993_0.15014836036220913"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-23T23:02:34.893Z","1.0.0":"2026-04-23T23:02:35.177Z","modified":"2026-04-23T23:02:35.455Z"},"maintainers":[{"name":"and1tech","email":"istrejo2106@gmail.com"}],"description":"MCP server for Obsidian vaults via direct filesystem access. Works with Claude Desktop and Claude Code.","homepage":"https://github.com/istrejo/obsidian-mcp#readme","keywords":["mcp","model-context-protocol","obsidian","claude","claude-code","claude-desktop","notes","knowledge-management","ai"],"repository":{"type":"git","url":"git+https://github.com/istrejo/obsidian-mcp.git"},"author":{"name":"José Alejandro Trejo Rivera","email":"istrejo2106@gmail.com"},"bugs":{"url":"https://github.com/istrejo/obsidian-mcp/issues"},"license":"MIT","readme":"# @istrejo/obsidian-mcp\n\n> MCP server that connects Claude (Desktop & Code) to your Obsidian vault via direct filesystem access.\n\n[![npm version](https://img.shields.io/npm/v/@istrejo/obsidian-mcp)](https://www.npmjs.com/package/@istrejo/obsidian-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@istrejo/obsidian-mcp)](https://www.npmjs.com/package/@istrejo/obsidian-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![CI](https://github.com/istrejo/obsidian-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/istrejo/obsidian-mcp/actions/workflows/ci.yml)\n\n## Features\n\n- **13 powerful tools** for reading, writing, searching, and organizing notes\n- **Direct filesystem access** — no Obsidian plugins required, works even if Obsidian is closed\n- **Secure by design**: path traversal prevention, read-only mode, automatic backups before deletion\n- **Works with Claude Desktop AND Claude Code** via stdio transport\n- **Zero configuration** beyond pointing it at your vault path\n\n## Requirements\n\n- Node.js >= 20\n- An existing Obsidian vault\n\n## Installation & Setup\n\n### For Claude Desktop\n\n1. Open your Claude Desktop config file:\n   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - **Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n2. Add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@istrejo/obsidian-mcp\"],\n      \"env\": {\n        \"OBSIDIAN_VAULT_PATH\": \"/absolute/path/to/your/vault\"\n      }\n    }\n  }\n}\n```\n\n3. Restart Claude Desktop.\n\n### For Claude Code\n\nRun this command in your terminal:\n\n```bash\nclaude mcp add obsidian -e OBSIDIAN_VAULT_PATH=/absolute/path/to/your/vault -- npx -y @istrejo/obsidian-mcp\n```\n\nOr manually edit `~/.claude/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@istrejo/obsidian-mcp\"],\n      \"env\": {\n        \"OBSIDIAN_VAULT_PATH\": \"/absolute/path/to/your/vault\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `OBSIDIAN_VAULT_PATH` | ✅ Yes | — | Absolute path to your Obsidian vault directory |\n| `OBSIDIAN_READ_ONLY` | No | `false` | Set to `true` to disable all write/delete operations |\n| `OBSIDIAN_MAX_FILE_SIZE` | No | `10485760` (10 MB) | Maximum file size in bytes for read/write operations |\n| `OBSIDIAN_BACKUP_ENABLED` | No | `true` | Whether to create backups before deleting notes |\n| `OBSIDIAN_LOG_LEVEL` | No | `info` | Log verbosity: `debug`, `info`, `warn`, or `error` |\n\n## Available Tools\n\n| Tool | Description | Example Prompt |\n|------|-------------|----------------|\n| `read_note` | Read the full content and frontmatter of a note | *\"Read my note at Projects/my-project\"* |\n| `list_notes` | List all notes, optionally filtered by folder | *\"List all notes in the Resources folder\"* |\n| `list_recent` | Show the most recently modified notes | *\"What are my 5 most recently edited notes?\"* |\n| `search_content` | Full-text search across all notes | *\"Search all my notes for 'microservices'\"* |\n| `search_by_tags` | Find notes by their tags | *\"Find all notes tagged #project/active\"* |\n| `create_note` | Create a new note with optional frontmatter | *\"Create a daily note for today in the Daily folder\"* |\n| `update_note` | Append, prepend, or replace note content | *\"Add a summary section to my meeting note\"* |\n| `manage_frontmatter` | Read or update YAML frontmatter | *\"Set the status field to 'done' in my task note\"* |\n| `manage_folders` | Create, list, or delete folders | *\"Create a folder called Archive/2024\"* |\n| `move_note` | Move or rename a note, updating backlinks | *\"Rename Projects/old-name to Projects/new-name\"* |\n| `delete_note` | Delete a note (with automatic backup) | *\"Delete the draft note at Drafts/scratch\"* |\n| `get_backlinks` | Find all notes that link to a given note | *\"Which notes link to Resources/book?\"* |\n| `get_graph` | Get the full wikilink connection graph | *\"Show me how my notes are connected, starting from index\"* |\n\n## Security\n\n- **Path traversal prevention:** All paths are validated to remain within your vault boundaries. Requests like `../../../etc/passwd` are rejected outright.\n- **Read-only mode:** Set `OBSIDIAN_READ_ONLY=true` to disable all write and delete operations. Useful for giving Claude read access to your vault without risk.\n- **Automatic backups:** Before deleting any note, a copy is saved to `.obsidian-mcp-trash/{timestamp}/` inside your vault. Set `OBSIDIAN_BACKUP_ENABLED=false` to disable.\n- **File size limits:** Files larger than `OBSIDIAN_MAX_FILE_SIZE` bytes are rejected to prevent runaway reads/writes.\n- **Structured logs:** All destructive operations (create, update, delete, move) are logged to stderr with timestamps.\n\n## Usage Examples\n\n```\n\"Create a new daily note for today in the Daily folder with tags: daily, journal\"\n\n\"Search all my notes for 'microservices' and summarize what I've written about the topic\"\n\n\"Find all notes tagged #project/active that haven't been modified in the last 30 days\"\n\n\"Move all notes in the Inbox folder to the appropriate project subfolders\"\n\n\"Show me everything that links back to my 'index' note\"\n\n\"Build a knowledge graph starting from my 'architecture' note, 3 hops deep\"\n```\n\n## Development\n\n```bash\ngit clone https://github.com/istrejo/obsidian-mcp.git\ncd obsidian-mcp\nnpm install\n\n# Run in dev mode (uses tsx, no build needed)\nOBSIDIAN_VAULT_PATH=/path/to/vault npm run dev\n\n# Type check\nnpm run typecheck\n\n# Lint\nnpm run lint\n\n# Run tests\nnpm test\n\n# Build for production\nnpm run build\n```\n\n## Contributing\n\nPRs welcome. Please follow [Conventional Commits](https://www.conventionalcommits.org/):\n\n- `feat:` new feature\n- `fix:` bug fix\n- `docs:` documentation only\n- `chore:` build/tooling\n- `test:` tests only\n- `refactor:` refactoring\n\n## License\n\nMIT © [José Alejandro Trejo Rivera](https://github.com/istrejo)\n","readmeFilename":"README.md","_rev":"1-ad9340d6ebd63f835d1518ee29996a92"}