Typescript MCP Server with Obsidian Integration

What is Typescript MCP Server with Obsidian Integration?

A command-line interface (CLI) for interacting with your Obsidian vault, built as a Model Context Protocol (MCP) server. It allows developers to search, list, and read notes via CLI commands or an HTTP API.

How to use Typescript MCP Server with Obsidian Integration?

Set up by cloning the repository, installing dependencies (npm install), and creating a .env file with your vault path (OBSIDIAN_VAULT_PATH). Then run commands like npm run cli search "query", npm run cli list "directory", or npm run cli read "path/to/note.md". Optionally install globally with npm link to use obsidian-cli from anywhere.

Key features of Typescript MCP Server with Obsidian Integration

• Search notes by text content with configurable result limits
• List notes in any vault directory (default 10 results)
• Read full content of a specific note file
• HTTP API endpoints for search, list, and read operations
• React frontend available at http://localhost:5173
• Global CLI installation for system-wide use
• Development mode with auto-reload via nodemon

Use cases of Typescript MCP Server with Obsidian Integration

• Automate note retrieval for development workflows or scripts
• Integrate with MCP-compatible clients to query an Obsidian vault
• Quickly search and read notes from the command line without opening Obsidian
• Build custom tooling that indexes or processes vault content