MCP Tools¶

ObsidianPalace exposes five tools via the Model Context Protocol. Any MCP-compatible client (Claude Desktop, Claude iOS, claude.ai) can invoke these tools after establishing an authenticated SSE connection.

Connection¶

Connect to the MCP server at:

SSE: https://YOUR_URL/sse
Messages: https://YOUR_URL/messages/

All requests require a valid Google OAuth 2.0 Bearer token in the Authorization header.

search_vault¶

Semantic search across the Obsidian vault using MemPalace (ChromaDB). Returns relevant notes ranked by similarity score.

Input Schema¶

Example¶

{
  "name": "search_vault",
  "arguments": {
    "query": "kubernetes deployment strategies",
    "limit": 5
  }
}

Response¶

Returns a formatted list of matching notes with their paths, similarity scores, and content previews (first 300 characters).

read_note¶

Read the full markdown content of a note from the vault by its relative path.

Input Schema¶

Example¶

{
  "name": "read_note",
  "arguments": {
    "path": "Projects/ObsidianPalace/design-notes.md"
  }
}

Response¶

Returns the full text content of the note.

write_note¶

Write or update a note in the vault. If no path is provided, AI-assisted placement determines the best location based on the vault structure and note content.

Input Schema¶

Example (explicit path)¶

{
  "name": "write_note",
  "arguments": {
    "path": "Daily/2026-04-11.md",
    "content": "# April 11, 2026\n\nWorked on ObsidianPalace docs today."
  }
}

Example (AI placement)¶

{
  "name": "write_note",
  "arguments": {
    "title": "Terraform Best Practices",
    "content": "# Terraform Best Practices\n\n## Directories over workspaces\n..."
  }
}

AI Placement Behavior¶

When path is omitted:

1. The server fetches the vault's current folder structure
2. Sends the folder tree, title, and content preview to Claude
3. Claude returns a recommended path (e.g., Engineering/Infrastructure/terraform-best-practices.md)
4. The note is written to that path, creating parent directories as needed

Fallback: If no Anthropic API key is configured or the API call fails, the note is written to Inbox/{title}.md.

list_folders¶

List the folder structure of the vault at a given path.

Input Schema¶

Example¶

{
  "name": "list_folders",
  "arguments": {
    "path": "Projects"
  }
}

Response¶

Returns a newline-separated list of subdirectories at the given path.

list_notes¶

List note files (.md files) in a vault folder.

Input Schema¶

Example¶

{
  "name": "list_notes",
  "arguments": {
    "path": "Daily"
  }
}

Response¶

Returns a newline-separated list of markdown files in the given folder.