Obsidian模型上下文协议服务器

# Install via uvx (no permanent installation)
uvx mcp-apple-obsidian

# Or install via pip
pip install mcp-apple-obsidian

# Clone the repository
git clone https://github.com/mcp-servers/mcp-apple-obsidian.git
cd mcp-apple-obsidian

# Quick setup with Makefile
make setup

# Or manually
uv sync
uv pip install -e .

{
  "mcpServers": {
    "apple-obsidian": {
      "command": "uvx",
      "args": ["--from", "/path/to/mcp-apple-obsidian", "mcp-apple-obsidian"],
      "env": {
        "OBSIDIAN_DEFAULT_VAULT": "My Vault"
      }
    }
  }
}

{
  "mcpServers": {
    "apple-obsidian": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-apple-obsidian", "mcp-apple-obsidian"],
      "env": {
        "OBSIDIAN_DEFAULT_VAULT": "My Vault"
      }
    }
  }
}

Read the content of my "Projects/Ideas" note from the "Personal" vault using obsidian_read_note.

Set the "status" property to "in-progress" in the note "Project Alpha" using obsidian_set_property.

Find all notes where the "priority" property equals "high" using obsidian_search_by_property.

Add the tag "urgent" to all notes in the Work folder using obsidian_add_tag.

Rename tag "old-project" to "new-project" across the entire vault using obsidian_rename_tag_vault.

What are the most used tags in my vault? Use obsidian_list_all_tags.

Add a task "Review quarterly report" due 2024-12-31 with high priority to my daily note using obsidian_add_task.

Find all incomplete tasks tagged with "work" using obsidian_search_tasks.

Mark the task "Email client" as complete in the Projects/Clients note using obsidian_complete_task.

Search for all notes containing "meeting" in the "Work" vault using obsidian_search_notes.

Find all notes with property "type" set to "project" and tag "active" using obsidian_search_by_property and obsidian_find_notes_by_tag.

Open the daily note in Obsidian and bring it to the foreground using obsidian_open_daily_note and obsidian_focus_app.

Create a new note called "Meeting Notes 2024-01-15" in the Work/Meetings folder with tags: work, meeting, january using obsidian_create_note.

Find all notes that link to "Project Alpha" and list their tags using obsidian_find_backlinks.

# Via uvx (no installation required)
uvx mcp-apple-obsidian

# Via pip
pip install mcp-apple-obsidian
mcp-apple-obsidian

# Build and test
make build
make publish-test

# Release to PyPI
make release VERSION=0.1.0

# Setup development environment
make setup

# Run tests
make test              # All tests
make test-unit         # Unit tests only
make test-coverage     # With coverage report

# Code quality
make lint              # Run linters
make format            # Format code
make check             # Run all checks (lint + test)
make fix               # Fix auto-fixable issues

# MCP Server installation
make install-claude    # Configure for Claude Desktop
make install-kimi      # Configure for Kimi CLI
make install-local     # Install for local testing

# Release
make build             # Build distribution
make publish-test      # Publish to TestPyPI
make publish           # Publish to PyPI
make release VERSION=0.1.0  # Full release workflow

# See all available targets
make help

# Using Makefile
make test

# Or directly
uv run pytest

make format
# Or: uv run ruff format .

# With default vault
OBSIDIAN_DEFAULT_VAULT="My Vault" make run

# Or directly
OBSIDIAN_DEFAULT_VAULT="My Vault" uv run mcp-apple-obsidian

make inspector
# Or: npx @modelcontextprotocol/inspector uv run mcp-apple-obsidian

- [ ] Incomplete task
- [x] Completed task
- [ ] Task with due date 📅 2024-12-25
- [ ] High priority task 🔼
- [ ] Low priority task 🔽
- [ ] Task with #tag