A
securityA
licenseA
qualityThis TypeScript-based MCP server enables users to manage a simple notes system with capabilities to create and summarize notes through structured prompts and resources.
Last updated -
5
0TypeScript
MIT License
The Obsidian MCP Server enables Obsidian vault data access and integration through the Model Context Protocol.
- Access Vault Contents: Retrieve structured JSON data of your Obsidian vault through the
get_vault_contentstool, with optional path parameter to target specific directories. - Server Information: Get information about the Obsidian server itself.
- Metadata Access: Obtain vault metadata alongside content in JSON format.
- Development Support: Includes debugging through MCP Inspector and development utilities like auto-rebuild with
npm run watch.
Provides access to Obsidian vault contents, allowing retrieval of vault files and metadata through the 'get_vault_contents' tool. Connects to the Obsidian API to retrieve information about the vault structure and file contents.
A Model Context Protocol server for Obsidian integration
This is a TypeScript-based MCP server that implements integration with Obsidian. It demonstrates core MCP concepts by providing:
- Resources representing Obsidian vault contents
- Tools for accessing vault data
- API integration with Obsidian
Project Statistics
- Total lines of code: 345
- Main files:
src/tool-handlers.ts(76 lines)src/resource-handlers.ts(45 lines)src/server.ts(32 lines)src/api-client.ts(25 lines)
Directory Structure
Features
Resources
- Access Obsidian server info via
obsidian://server-infoURI - Get vault contents with metadata
- JSON format for easy integration
Tools
get_vault_contents- Retrieve contents of Obsidian vault- Takes path as optional parameter (default: root directory)
- Returns structured JSON response
API Integration
- Secure HTTPS connection with Obsidian API
- Custom axios client with error handling
- Windows path normalization support
Development
Prerequisites
- Node.js v18+
- TypeScript 5.3+
- Obsidian API key (set as OBSIDIAN_API_KEY environment variable)
Setup
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Debugging
We recommend using the MCP Inspector:
The Inspector will provide a URL to access debugging tools in your browser.
Dependencies
Runtime
- @modelcontextprotocol/sdk: MCP server implementation
- axios: HTTP client for API communication
Development
- @types/node: TypeScript definitions for Node.js
- typescript: TypeScript compiler
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
This TypeScript-based MCP server enables users to manage and summarize text notes, providing tools for note creation and summarization prompts.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis TypeScript-based server implements a simple notes system using MCP concepts, enabling users to create, list, and summarize text notes through natural language prompts.Last updated -5109159JavaScriptMIT License
- AsecurityFlicenseAqualityA TypeScript-based MCP server that implements a simple notes system, enabling users to manage text notes with creation and summarization functionalities through structured prompts.Last updated -1289JavaScript
- AsecurityFlicenseAqualityA TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes.Last updated -121TypeScript
Appeared in Searches
- A lightweight MCP server for managing Markdown files without external dependencies
- Improving React Native Development Experience
- Information about Yank Notes
- Finding Minecraft servers with client information support for integration in a TypeScript project
- Obsidian - A Search for Its Uses and Applications