MCP Obsidian Planner

Connects Claude Code MCP client to an Obsidian vault to manage daily notes, inbox, tasks, projects, weekly reviews, and full-text search.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jarero321-mcp-obsidian-planner": {
      "command": "node",
      "args": [
        "/path/to/mcp-obsidian-planner/dist/main.js"
      ],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

This MCP Server enables Claude Code to connect directly to your Obsidian vault for organized planning using GTD and PARA methods. It provides daily notes, inbox management, tasks, projects, weekly reviews, and full-text search within your vault, helping you plan, review, and act with clarity.

How to use

You run the MCP server locally and connect your MCP client (such as Claude Code) to your Obsidian vault. From there you can generate and manage daily notes, capture items into an inbox, create and track tasks and projects, generate weekly reviews, and search across your vault with context. The server uses a clean architecture to separate domain logic from data access, ensuring you can extend or customize it while keeping a solid flow for planning work.

How to install

Follow these steps to set up the MCP server on your machine.

Additional sections

Prerequisites include Node.js version 18 or newer. You will also need an Obsidian vault with the expected folder structure to organize your daily notes, inbox, areas, and projects.

Environment, transport, and structure

The server reads configuration from environment variables and supports stdio transport for local runs and SSE for web clients. It operates on a Vault structure that includes folders such as Daily notes, Inbox, Areas, Projects, and Archive, with templates used to generate consistent notes.

Available tools

daily_create

Create a daily note from a template. Returns existing note if already created.

daily_get

Get a daily note with parsed sections (focus, tasks, log, gratitude, reflection).

daily_set_focus

Set the Top 3 focus priorities for a daily note.

inbox_list

List all inbox items grouped by priority (Urgente, Puede esperar, Algún día, Captura Rápida, Notas Rápidas).

inbox_add

Add a new item to the inbox with timestamp.

inbox_process

Move an inbox item to a project, daily note, area, archive, or delete it.

inbox_prioritize

Change the priority of an inbox item between sections.

tasks_list

List tasks from a specific note, folder, or the entire vault. Filter by status.

task_toggle

Toggle a task between pending [ ] and completed [x].

task_add

Add a new task to a note in a specific section.

weekly_summary

Generate weekly summary: completed/pending tasks, dailies filled, project progress.

weekly_create

Create a weekly review note from template.

vault_search

Full-text search across the vault with context lines.

note_read

Read a note from the vault by its relative path.

notes_list

List all notes in a folder with optional pattern filter.

projects_list

List projects with status, area, deadline. Filter by status or area.

project_create

Create a new project from template with area assignment.