Obsidian — Cotton

Cotton ↔ Obsidian tie-in is INFERRED, not documented. The connection between cotton agent workflows and Obsidian vaults is assembled from individual skill files — there is no single canonical source that documents them as an integrated system. Treat this section as a best-effort synthesis, not an authoritative spec.

kdx-obsidian-install-mcp

This skill auto-detects the Obsidian vault on disk and writes a mcpServers.obsidian entry into .claude/settings.json. If no vault is found, it exits immediately.

Trigger phrases: kdx-obsidian-install-mcp, install obsidian mcp, configure obsidian mcp for this project.

The resulting settings.json snippet looks like:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "/path/to/your/vault"]
    }
  }
}

obsidian-mcp

obsidian-mcp is an MCP server that exposes vault notes to Claude Code tools. Once installed, Claude can read, create, and edit Obsidian notes directly via the standard Read/Write/Edit tool chain.

obsidian-bases

The obsidian-bases skill creates and edits .base files — the native Obsidian database layer for dynamic tables, card/list views, filters, formulas, and summaries over vault notes.

A minimal .base file example:

---
type: base
---

## Tasks

```base
from: "[[Tasks]]"
fields:
  - name: Status
    type: status
  - name: Due
    type: date
filter:
  - field: Status
    op: "!="
    value: Done
sort:
  - field: Due
    dir: asc
```

obsidian-markdown

The obsidian-markdown skill enforces correct Obsidian Flavored Markdown syntax for notes created or edited by Claude Code.

Wikilinks & embeds

[[Note Name]]                    # wikilink
[[Note Name|Display Text]]       # aliased wikilink
![[Note Name]]                   # embed note
![[image.png]]                   # embed image
![[Note Name#Heading]]           # embed section

Callouts

> [!NOTE]
> This is a note callout.

> [!WARNING]
> This is a warning.

> [!TIP]
> Use a + or - to expand/collapse:

> [!INFO]+
> Expanded by default.

Front-matter properties

---
title: My Note
tags: [cotton, agents]
date: 2026-05-30
status: active
---

Other syntax

==highlighted text==             # highlight
$$E = mc^2$$                     # block math
$E = mc^2$                       # inline math
#tag                             # hashtag
#nested/tag                      # nested tag