Obsidian Kanban

Provides an MCP server to manage Obsidian Kanban boards stored in a vault with actions to list, read, add, move, and create boards.

typescript

GitHub Stars

typescript

Language

5 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": {
    "trung-persefoni-obsidian-kanban-mcp": {
      "command": "node",
      "args": [
        "/path/to/mcp-obsidian-kanban/dist/index.js"
      ],
      "env": {
        "VAULT_PATH": "${VAULT_PATH} (defaults to ~/workspace/cursor-vault)",
        "OBSIDIAN_BOARD_NAME": "MyBoard.md"
      }
    }
  }
}

You run an MCP server that manages Obsidian Kanban boards stored in your vault. It lets you list boards, read their columns and tasks, add tasks to columns, move tasks between columns, and create new boards, all through MCP clients.

How to use

Use an MCP client to interact with the Obsidian Kanban MCP Server. You can list boards, inspect a board’s columns and tasks, add new tasks to a specific column, move tasks between columns, and create new boards. You can also customize whether task details are stored on the card or in a separate note.

Typical workflows you can perform after starting the server include:

List all kanban boards in your vault
Read the content of a board to see its columns and tasks
Add a new task to a chosen column with optional details
Move an existing task from one column to another
Create a new Kanban board with predefined columns

How to install

Prerequisites you need before installing: Node.js is installed on your system and your Obsidian vault includes the Kanban plugin.

Install dependencies and build the server, then run the compiled code.

npm install
npm run build

Additional setup notes

Configure the server to point at your Obsidian vault using the VAULT_PATH environment variable. If VAULT_PATH is not set, it defaults to ~/workspace/cursor-vault.

Optionally set OBSIDIAN_BOARD_NAME to a default board filename, for example MyBoard.md. If you set this, you do not need to provide the board_name argument in each request.

Running the server

Start the compiled server with Node.js. This runs the server from the dist/index.js file produced by the build step.

node dist/index.js

Deployment & MCP integration notes

This server exposes a standard MCP interface. You can connect to it from MCP clients either via a local stdio process or through an HTTP endpoint if you expose one in your environment.

Available tools

list_boards

List all Kanban boards found in your vault.

get_board_content

Retrieve the columns and tasks for a specific board.

add_task

Add a new task to a designated column with optional details like description, labels, and acceptance criteria.

move_task

Move a task from one column to another within the same board.

create_board

Create a new Kanban board with specified columns.

Built by

VeilStrat

AI signals for GTM teams