Obsidian Vault Integration
FundAdmin AI includes a full Obsidian vault that turns your local Obsidian installation into a structured fund administration workspace. Every review, investor record, compliance check, and action item produced by FundAdmin AI's 59 skills can flow into the vault automatically, giving you a persistent, searchable, linked knowledge base for your fund portfolio.
Full Obsidian Ecosystem (v2)
The latest release adds 3 new MCP tools (vault_read_investor, vault_list_funds, vault_query_tracker), live Dataview JS dashboards across all 9 tracker registries, interactive Kanban boards with add/move/check support in the webapp, and a REST API server (webapp-api.js) for webapp vault write-back.
What the Vault Provides
The vault ships with a complete set of pre-built structure:
| Component | Count | Purpose |
|---|---|---|
| Dashboards | 7 | Dataview-powered live views of fund and investor data |
| Kanban boards | 9 | Workflow tracking mapped to skill categories |
| Templates | 7 | Daily, weekly, monthly, quarterly review templates |
| FileClasses | 3 | Metadata Menu schemas for Fund, Investor, and Review notes |
| Review subfolders | 12 | Organized output storage by skill category |
Setup
Step 1: Initialize the Vault
/fund vault-initThis command creates the vault at ~/FundAdmin-AI-Vault/ and builds the full directory structure: dashboards, Kanban boards, templates, FileClasses, and all 12 review subfolders.
Step 2: Install Required Obsidian Plugins
Open Obsidian, point it at ~/FundAdmin-AI-Vault/, then install and enable these community plugins:
| Plugin | Purpose |
|---|---|
| Dataview | Powers all dashboard queries |
| Kanban | Renders the 9 workflow boards |
| Metadata Menu | Enables dropdown fields in FileClasses |
| Meta Bind | Inline input forms in notes |
| QuickAdd | Fast note creation with templates |
| Charts | Portfolio performance visualizations |
| Obsidian Git | Auto-commit vault changes to a git repo |
Step 3: Connect the MCP Server
The MCP server exposes 15 tools that let FundAdmin AI read from and write to your vault without leaving the terminal:
claude mcp add fundadmin-vault -s user node mcp-vault-server/index.jsAfter adding, restart Claude Code. The mcp__fundadmin-vault__* tools are now available in every session.
Step 4: Sync Reviews
After running any review or analysis skill, sync the output to the vault:
/fund vault-syncThis writes the review as a structured note with YAML frontmatter, tags, and backlinks to the relevant fund and investor records.
MCP Server: 15 Tools
The MCP server uses stdio transport and writes to ~/FundAdmin-AI-Vault/. All tools are available as mcp__fundadmin-vault__<tool> after installation.
| Tool | What It Does |
|---|---|
vault_write_review | Create a new review note with YAML frontmatter and status |
vault_read_fund | Read a fund note and all linked reviews |
vault_update_fund | Update an existing fund note with new data |
vault_create_investor | Create an investor record with FileClass metadata |
vault_read_investor | Read an investor note and all linked fund positions |
vault_list_funds | List all funds in the vault with frontmatter metadata |
vault_query_tracker | Query tracker registries (capital, compliance, investor, performance) by fund or investor |
vault_add_kanban_card | Add a card to any Kanban board column |
vault_move_kanban_card | Move a card between columns |
vault_close_review | Mark a review as completed |
vault_archive_reviews | Batch-archive completed reviews (quarterly) |
vault_review_status | List reviews by status |
vault_list_action_items | Pull all open action items across all boards |
vault_search | Full-text search across all vault notes |
Review Lifecycle
Every review moves through a five-stage lifecycle tracked in its YAML frontmatter:
new → under-review → action-required → completed → archived| Status | Meaning | Typical Next Step |
|---|---|---|
new | Review created, not yet examined | Assign to reviewer |
under-review | Actively being analyzed | Generate findings |
action-required | Findings ready, LP action needed | Negotiate or escalate |
completed | All action items resolved | Archive quarterly |
archived | Historical record; no active items | Surfaced in trend views only |
Status transitions are tracked in the Review Kanban board and reflected instantly in the Dataview dashboards.
Dashboards
Seven Dataview-powered dashboards provide live views of your vault data. All dashboards update automatically as notes are added or modified.
| Dashboard | What It Shows |
|---|---|
| Portfolio Overview | All funds, safety scores, benchmark deviations, last review date |
| Action Items | Open P0/P1 items across all active reviews, sorted by priority |
| Risk Register | Risk scores by dimension, aggregated across the portfolio |
| KYC Status | Investor KYC expiration dates and outstanding document requests |
| Charts | Safety Score trends over time and deviation score distributions |
| Compliance Matrix | Framework PASS/WARNING/FAIL status across all funds |
| Quarterly Summary | Rolling 90-day view of completed reviews and resolved items |
Dataview JS Live Queries
All 9 tracker dashboards now use Dataview JS queries instead of static tables. Each dashboard file contains a dataviewjs code block that dynamically reads frontmatter from review notes and renders live, sortable tables. This means dashboards update automatically as new reviews are processed -- no manual editing of dashboard files is required.
The trackers powered by Dataview JS include:
| Tracker Dashboard | What It Queries |
|---|---|
| Capital Tracker | Cumulative capital calls, distributions, unfunded commitments, source breakdown per fund |
| Compliance Tracker | Risk flags (High/Medium/Low) extracted from reviews with severity aggregation |
| Investor Tracker | LP registry with cross-fund exposure, commitment totals, and contact metadata |
| Performance Tracker | Fund performance snapshots (IRR, TVPI, DPI) from capital account reviews |
| Wire Registry | Wire instruction changes with verification status and anomaly flags |
| Obligation Tracker | Side letter obligation deadlines with compliance status |
| KYC Tracker | KYC/AML document collection status and verification per investor |
| Covenant Tracker | Debt covenant compliance with threshold proximity alerts |
| Regulatory Tracker | Regulatory filing calendar with deadline tracking |
Each dashboard uses [[wikilinks]] to cross-reference fund and investor notes, so clicking any entry navigates directly to the source review.
Kanban Boards
Nine Kanban boards map directly to FundAdmin AI skill categories. Each board uses standard columns (Backlog, In Progress, Review, Done) and cards that link back to the source review note.
| Board | Maps To |
|---|---|
| LPA Review | Document Review skills |
| Investor Onboarding | Investor Compliance & Onboarding skills |
| Document Intake | Document Intake skills |
| Compliance Tracking | Compliance & Regulatory skills |
| Obligations | Tracking & Monitoring skills |
| Portfolio Intelligence | Portfolio Intelligence skills |
| Analytics | Analytics & Modeling skills |
| Action Items | Cross-category open items |
| Risk Register | Risk findings from all review types |
Templates
Seven note templates are included for structured periodic review:
| Template | Cadence | Contents |
|---|---|---|
| Daily Review | Daily | Today's action items, capital call notices, KYC expirations |
| Weekly Review | Weekly | Review completions, open negotiations, upcoming filings |
| Monthly Review | Monthly | Portfolio performance summary, obligation tracker status |
| Quarterly Review | Quarterly | Safety score trends, benchmark deviations, archive sweep |
| Fund Onboarding | Per fund | Fund setup checklist, LPA intake, initial benchmark |
| Investor Onboarding | Per investor | Subscription pipeline status, KYC document checklist |
| Side Letter Tracker | Per side letter | MFN provisions, LP-specific rights, expiration monitoring |
FileClasses
Three Metadata Menu FileClasses define the structured fields on every Fund, Investor, and Review note. FileClasses enable dropdown-based data entry and consistent frontmatter across all notes.
Fund FileClass
| Field | Type | Options |
|---|---|---|
strategy | Dropdown | PE Buyout, Venture Capital, Real Estate, Credit, Hedge Fund, Growth Equity, Fund-of-Funds |
vintage | Number | Year |
target_size | Number | USD millions |
safety_score | Number | 0-100 |
status | Dropdown | Fundraising, Investing, Harvesting, Wind-Down, Closed |
Investor FileClass
| Field | Type | Options |
|---|---|---|
investor_type | Dropdown | U.S. Individual, U.S. Entity, Tax-Exempt, Benefit Plan, Government, Non-U.S. Individual, Non-U.S. Entity, Financial Institution, Fund-of-Funds, Special |
fatca_status | Dropdown | W-9 collected, W-8BEN collected, W-8BEN-E collected, Pending, Not required |
aml_status | Dropdown | Cleared, Flagged, Pending, Escalated |
kyc_status | Dropdown | Current, Expiring (90d), Expired, Not started |
qualification | Dropdown | Accredited Investor, Qualified Client, Qualified Purchaser |
Review FileClass
| Field | Type | Options |
|---|---|---|
review_type | Dropdown | LPA Review, PPM Review, Subscription Review, Side Letter, Compliance Check, KYC Review, Benchmark |
status | Dropdown | new, under-review, action-required, completed, archived |
priority | Dropdown | P0, P1, P2, P3, P4 |
safety_score | Number | 0-100 (for LPA reviews) |
Webapp REST API (webapp-api.js)
The webapp API server provides a REST interface for the Next.js webapp to write back to the Obsidian vault. It runs on 127.0.0.1:3001 and exposes 4 endpoints for review status updates and Kanban board operations.
Startup
node mcp-vault-server/webapp-api.jsEndpoints
| Method | Path | Description |
|---|---|---|
PATCH | /api/reviews/:id/status | Update a review's frontmatter status field |
POST | /api/kanban/:board/cards | Add a new card to a Kanban board column |
PATCH | /api/kanban/:board/cards/:id/move | Move a card between columns |
PATCH | /api/kanban/:board/cards/:id/check | Toggle a card's checkbox state |
All writes go through the same vault.js functions used by the MCP server, ensuring a single mutation channel for vault state. The server binds to 127.0.0.1 only (no external access).
Review Metadata Extraction (parseReviewMetadata)
The inbox watcher (mcp-vault-server/watcher.js) extracts actual risk ratings, safety scores, and investor lists from Claude's review output via the parseReviewMetadata function in vault.js. This replaces earlier hardcoded placeholder values with real data parsed from the review markdown.
Extracted fields include:
| Field | Source | Example |
|---|---|---|
risk | Risk Assessment section of review output | High, Medium, Low |
score | LPA Safety Score or Health Score | 72 |
investors | Investor names mentioned in the review | ["CalPERS", "OTPP", "GIC"] |
These values are written into the YAML frontmatter of each vault review note, enabling accurate Dataview queries across the portfolio.