Obsidian MCP Server

Instructions

Implementation Reference

• src/obsidian_mcp/vault.py:259-280 (handler)

  Core handler implementation: reads note content, extracts wikilinks using _extract_links, resolves each link to vault paths using _resolve_link, returns list of resolved paths.
  async def get_outgoing_links(self, relative_path: str) -> list[str]: """ Get all outgoing links from a note. Args: relative_path: Path to the note Returns: List of linked note paths (relative to vault) """ note = await self.read_note(relative_path) links = self._extract_links(note.content) # Resolve links to actual file paths resolved = [] for link in links: # Try to find the note in the vault resolved_path = self._resolve_link(link, relative_path) if resolved_path: resolved.append(resolved_path) return resolved
• src/obsidian_mcp/server.py:324-364 (registration)

  MCP tool registration decorator and wrapper function: validates input, calls vault.get_outgoing_links, formats results as numbered list string.
  @mcp.tool( name="get_outgoing_links", description="Get all links from a note to other notes (outgoing links)", ) async def get_outgoing_links(path: str) -> str: """ Get all outgoing links from a note. Args: path: Relative path to the note (e.g., "Projects/MCP.md") Returns: Formatted list of linked notes """ if not path or not path.strip(): return "Error: Path cannot be empty" if len(path) > 1000: return "Error: Path too long" context = _get_context() try: outgoing = await context.vault.get_outgoing_links(path) if not outgoing: return f"No outgoing links found in '{path}'" output = f"Found {len(outgoing)} outgoing link(s) from '{path}':\n\n" for i, link_path in enumerate(outgoing, 1): output += f"{i}. `{link_path}`\n" return output except FileNotFoundError: return f"Error: Note not found: {path}" except VaultSecurityError as e: return f"Error: Security violation: {e}" except Exception as e: logger.exception(f"Error getting outgoing links for {path}") return f"Error getting outgoing links: {e}"
• src/obsidian_mcp/vault.py:282-321 (helper)

  Helper: Resolves a wikilink alias to an actual relative file path by checking direct path, same folder, and full vault search.
  def _resolve_link(self, link: str, source_path: str) -> str | None: """ Resolve a wikilink to an actual file path. Args: link: Link destination (e.g., "My Note" or "folder/My Note") source_path: Path of the source note (for relative links) Returns: Resolved path or None if not found """ # If link already has extension, use as-is if link.endswith(".md"): link_path = link else: link_path = f"{link}.md" # Try direct path first try: if self.note_exists(link_path): return link_path except VaultSecurityError: pass # Try in same folder as source source_dir = str(Path(source_path).parent) if source_dir != ".": try: same_folder_path = f"{source_dir}/{link_path}" if self.note_exists(same_folder_path): return same_folder_path except VaultSecurityError: pass # Search for file by name in entire vault for note_meta in self.list_notes(limit=10000): if note_meta.name == link or note_meta.path == link_path: return note_meta.path return None