Obsidian Integration Plugin¶

Integration with Obsidian via the TaskNotes Plugin API - task management directly from Claude Code.

Version 1.1.2¶

This plugin enables seamless task management between Claude Code and Obsidian using the TaskNotes Plugin API.

Features¶

• List tasks - "show my tasks"
• Create tasks - "create a task for X"
• Update tasks - Change status, add details
• Delete tasks - Remove tasks
• Work recommendations - "what should I work on?"
• Vault-wide scanning - Find all tasks in your entire vault with --scan

Prerequisites¶

1. TaskNotes Plugin in Obsidian¶

1. Open Obsidian Community Plugins
2. Search for "TaskNotes" and install
3. Enable the plugin

2. Enable HTTP API¶

1. Obsidian Settings → TaskNotes
2. Enable "HTTP API" toggle
3. Set port (default: 8080)
4. Optional: Set API token for security

3. Environment Variables (optional)¶

If using authentication, create a .env file in your Obsidian vault:

1
2

TASKNOTES_API_PORT=8080
TASKNOTES_API_KEY=your_secret_token

Alternatively, set OBSIDIAN_VAULT_PATH as an environment variable to specify the vault path.

Installation¶

Via Marketplace¶

1
2
3
4
5

{
  "enabledPlugins": {
    "obsidian@talent-factory": true
  }
}

Local Testing¶

1

claude --plugin-dir ./plugins/obsidian

Usage¶

Natural Language¶

1
2
3
4

show my tasks
create a task to finish the landing page
what should I work on?
mark "Tasks/landing-page.md" as done

CLI Commands¶

The plugin also provides direct CLI commands:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# List all tasks in the vault (recommended)
uv run tasks.py list --scan --table

# List all tasks including completed
uv run tasks.py list --all --table

# Create a task
uv run tasks.py create "Prepare meeting" --project "Work" --priority high

# Update status
uv run tasks.py update "Tasks/meeting.md" --status done

# Filter by status
uv run tasks.py list --status in-progress --scan --table

Skills¶

See Skills & Agents Activation Guide for detailed activation instructions.

tasknotes¶

Main skill for task management. Automatically activated for:

• Task-related requests
• Task management questions
• Productivity workflows

Key Features:

• --scan flag: Scans the entire vault filesystem to find ALL tasks with the #task tag
• --all flag: Includes completed and cancelled tasks in listings
• Automatic vault detection via .obsidian folder
• Smart sorting by scheduled/due dates

Project Structure¶

1
2
3
4
5
6
7
8
9

obsidian/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── tasknotes/
│       ├── SKILL.md
│       └── scripts/
│           └── tasks.py
└── README.md

Changelog¶

Version 1.1.2 (2026-02-27)¶

• Added keywords and license fields to plugin.json
• Fixed author email to support@talent-factory.ch
• Improved tasknotes skill description

Related Plugins¶

• Project Management - PRD and task planning
• Git Workflow - Commit and PR automation

License¶

MIT License - see LICENSE for details.

Made with care by Talent Factory GmbH