Obsidian Todos MCP Server

Model Context Protocol (MCP) server that provides AI assistants with direct access to Obsidian todos through the Local REST API.

Features

• 🔍 List todos - Get all incomplete todos from your vault

• ➕ Add todos - Create new todos in today's daily note

• ✏️ Update todos - Modify existing todos or mark them complete

• 📊 Get stats - View todo statistics by file

Prerequisites

1. Obsidian with the following plugins installed and enabled:

   • Local REST API

   • Dataview

   • Todos REST API (this plugin)

2. Node.js 18+ installed

Installation

From npm (coming soon)

From source

Configuration

Environment Variables

• OBSIDIAN_API_URL - Base URL for the REST API (default: http://localhost:27124)

• OBSIDIAN_API_KEY - API key if authentication is enabled

Claude Desktop Configuration

Add to your claude_desktop_config.json:

Or use the direct binary name after npm link:

Or if running from source:

Available Tools

list_todos

Lists all incomplete todos from your Obsidian vault.

Example:

add_todo

Adds a new todo to today's daily note.

Parameters:

• text (string, required) - The todo text

Example:

update_todo

Updates an existing todo (mark complete, change text, etc.).

Parameters:

• file (string, required) - Path to file containing the todo

• line (number, required) - Line number of the todo (0-indexed)

• text (string, optional) - New text for the todo

• completed (boolean, optional) - Mark as complete/incomplete

Example:

get_todo_stats

Get statistics about your todos.

Example:

Development

Troubleshooting

Connection Issues

1. Ensure Obsidian Local REST API is running

2. Check the API URL is correct (default: http://localhost:27124)

3. Verify the Todos REST API plugin is enabled in Obsidian

Authentication Errors

If you have authentication enabled in Local REST API:

1. Set the OBSIDIAN_API_KEY environment variable

2. Or update your Claude Desktop config with the API key

License

MIT