Vault Cortex
MCP serverby aliasunderSRC
Standalone MCP server for Obsidian vaults — hybrid search, notes & files, memory, tasks, OAuth 2.1
SRC Publisher-stated: these are the publisher's own words, not an assessment.
Key facts
- Type
- MCP server · mcp-localSRC
- Publisher
- aliasunder · individualSRC
- Licence
- MITSRC
- Open source
- YesDER
- Hosting
- Local (runs on your machine)SRC
- Latest version
- 1.0.0SRC
- Languages
- typescriptSRC
- First published
- SRC
- In this catalogue since
- DER
- Last verified
- Not verified by a researcher. Last seen in a source on 2026-11-21.
Capabilities and categories
Assigned by keyword rules from the description unless marked otherwise. The matched word is shown so you can judge the match.
| Capability | Evidence | Kind |
|---|---|---|
| Knowledge Bases & Wikis | matched knowledge base | DER |
| Note-taking | matched obsidian | DER |
| Task Management | matched task management | DER |
| Obsidian Vaults | matched obsidian | DER |
| Personal Knowledge Management | matched obsidian | DER |
| Semantic Search | matched semantic search | DER |
| Similarity Search | matched hybrid search | DER |
Filed underData & KnowledgeProductivity & CollaborationNotes & DocumentsProject ManagementResearch & KnowledgeRetrieval & RAGRetrieval-Augmented GenerationVector Databases
Integrations DER
Platform compatibility
No pairing has been tested by AgentSidekick. Each status says what kind of evidence exists, not whether it works for you.
Protocol-level29
Each platform listed officially documents support for MCP. This specific pairing has not been tested.
Platform discontinued1
| Platform | Basis |
|---|---|
| Roo CodeDiscontinued | Roo Code documented support for MCP but is discontinued. Project shut down and repository archived. |
Unknown17
| Platform | Basis |
|---|---|
| OpenClaw | Could not confirm whether OpenClaw supports MCP. |
| OpenHands | OpenHands documents MCP support, but it runs only on web, api, slack surfaces and this server runs locally as a process on your machine. Whether OpenHands can reach a local server is not established. |
| Aider | Could not confirm whether Aider supports MCP. |
| Bolt (bolt.new) | Bolt (bolt.new) documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Bolt (bolt.new) can reach a local server is not established. |
| Amazon Q DeveloperWinding down | Could not confirm whether Amazon Q Developer supports MCP. |
| Amazon Bedrock Agents (Agents Classic)Maintenance only | Could not confirm whether Amazon Bedrock Agents (Agents Classic) supports MCP. |
| GPTs (custom GPTs)Winding down | Could not confirm whether GPTs (custom GPTs) supports MCP. |
| Gemini (app) | Gemini (app) documents MCP support, but it runs only on web, mobile surfaces and this server runs locally as a process on your machine. Whether Gemini (app) can reach a local server is not established. |
| Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) | Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) can reach a local server is not established. |
| GitHub Copilot ExtensionsDiscontinued | Could not confirm whether GitHub Copilot Extensions supports MCP. |
| Google AI Studio | Could not confirm whether Google AI Studio supports MCP. |
| JulesWinding down | Could not confirm whether Jules supports MCP. |
| Microsoft Copilot | Could not confirm whether Microsoft Copilot supports MCP. |
| Microsoft Copilot Studio | Microsoft Copilot Studio documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Microsoft Copilot Studio can reach a local server is not established. |
| Replit Agent | Replit Agent documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Replit Agent can reach a local server is not established. |
| Sourcegraph Cody | Could not confirm whether Sourcegraph Cody supports MCP. |
| v0 | v0 documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether v0 can reach a local server is not established. |
Install
Read from registry metadata. Follow the publisher's instructions; we have not run this.
| Registry | Package | Transport | Runtime |
|---|---|---|---|
| oci | ghcr.io/aliasunder/vault-cortex:1.0.0 | streamable-http | docker |
Environment variables SRC
| Name | Required | Secret | Publisher's description |
|---|---|---|---|
| MCP_AUTH_TOKEN | Yes | Secret | Bearer token for MCP client authentication. Must match the Authorization header sent by clients. Generate with: openssl rand -hex 32 |
| PUBLIC_URL | No | No | Public URL clients use to reach this server. Used as the OAuth issuer URL in discovery metadata. Override when exposing the server outside localhost or on a non-default port. |
| EMBEDDING_ENABLED | No | No | Enable or disable the embedding pipeline. When false, no ONNX model is downloaded, no vector tables are created, and search uses FTS5 only. |
| RERANK_MODE | No | No | Cross-encoder reranking mode: blended (position-aware score blending after RRF fusion) or none (skip reranking). Only takes effect when EMBEDDING_ENABLED is true. |
| WINDOWS_MODE | No | No | Windows bind-mount mode: enables filesystem polling for the file watcher and rename-based moves across the Docker Desktop/WSL2 bridge. Set to true when the vault lives on a Windows drive. |
| MEMORY_ENABLED | No | No | Enable or disable the structured memory layer. When false, memory tools are hidden, bootstrap is skipped, and server metadata omits memory references. |
| FILE_TOOLS_ENABLED | No | No | Enable or disable file tools (vault_read_file, vault_list_files). When false, file tools are hidden and server metadata omits file tool references. |
| READONLY_MODE | No | No | Run the server read-only: every vault-writing tool is hidden, the memory folder is not auto-created, and server metadata omits write references. |
| DISABLED_TOOLS | No | No | Hide individual tools by name, comma-separated. Subtractive only — it cannot re-enable a tool another setting hides; an unknown tool name stops the server at startup. |
| MEMORY_DIR | No | No | Vault folder for structured memory files (About Me-style notes). Memory tools are hidden when MEMORY_ENABLED is false, but this value still feeds the defaults for PROTECTED_PATHS and ORPHAN_EXCLUDE_FOLDERS. |
| DAILY_NOTES_FOLDER | No | No | Vault folder for daily notes. Overrides the folder configured in Obsidian's daily-notes plugin. When unset, read from the vault's .obsidian/daily-notes.json (an empty folder there follows Obsidian's new-note location), falling back to "Daily Notes" when that file is missing or unreadable. Set to / for the vault root. |
| DAILY_NOTES_FORMAT | No | No | Filename date format for daily notes (Moment.js tokens). Overrides the format configured in Obsidian's daily-notes plugin. When unset, read from the vault's .obsidian/daily-notes.json, falling back to "YYYY-MM-DD". |
| TRUST_PROXY_HOPS | No | No | Number of trusted reverse-proxy hops used to derive the client IP from X-Forwarded-For for OAuth rate limiting and request logs. With 0, injected forwarding headers are ignored. |
| TRUST_FORWARDED_HOPS | No | No | How many entries from the end of the RFC 7239 Forwarded header's for= list to count to reach the client IP for OAuth rate limiting and request logs. 0 ignores the header; 1 when the proxy in front writes it (e.g. AWS API Gateway) and is the only way to reach the server; 2 when a CDN fronts that proxy and is the only way to reach it. |
| TZ | No | No | IANA timezone for timestamps and daily note resolution. |
| LOG_LEVEL | No | No | Logging verbosity. |
| LOG_DIR | No | No | Directory for log files that survive container re-creation. The container's own log is always written but discarded when the container is recreated; date-stamped files under LOG_DIR persist on the data volume. Default: /data/logs (remote image), $STORAGE_ROOT/data/logs (single-volume mode), none (local image). none keeps only the container log. |
| LOG_RETENTION_DAYS | No | No | Days to keep log files; cleanup runs at startup and each day. Only applies when LOG_DIR is a path. |
| LOG_MAX_DAILY_MB | No | No | Maximum MB per daily log file (1 MB = 1,000,000 bytes). Whole numbers of at least 1, or none to disable the cap. File logging pauses at the cap until midnight in TZ (UTC by default); console logging continues. |
| PROTECTED_PATHS | No | No | Comma-separated vault folder names blocked from vault_delete_note and vault_move_note. Default: MEMORY_DIR plus the daily notes folder, read from DAILY_NOTES_FOLDER or .obsidian/daily-notes.json (default Daily Notes; none when that setting is the vault root or empty). When set, overrides the default entirely. |
| ORPHAN_EXCLUDE_FOLDERS | No | No | Comma-separated vault folder names excluded from vault_find_orphans. Default: the daily notes folder, "Templates", and MEMORY_DIR. DAILY_NOTES_FOLDER wins; otherwise .obsidian/daily-notes.json is read per query (fallback "Daily Notes"; no daily folder when that setting is the vault root or empty). When set, replaces the defaults entirely. Set to a comma (,) to exclude nothing; an empty value uses the defaults. |
| SERVICE_DOCUMENTATION_URL | No | No | Override the OAuth service documentation URL exposed via discovery metadata. |
| MAX_FILE_BYTES | No | No | Largest file vault_read_file will read, in bytes. Reading a larger file returns an error instead of content. |
| MAX_IMAGE_OUTPUT_BYTES | No | No | Byte budget for images returned by vault_read_file, in binary bytes before base64 encoding. Images exceeding the budget are downscaled/recompressed server-side to fit; raise for clients that accept larger tool responses. |
| MAX_PDF_RENDER_PAGES | No | No | Maximum PDF pages to render as images when raw: true is set on vault_read_file. The per-page byte budget is MAX_IMAGE_OUTPUT_BYTES divided evenly across the rendered pages. |
Permissions and signals
Signals, not a safety verdict. They describe what the product's metadata references. Security review: not reviewed.
| Signal | Evidence | How observed | Observed |
|---|---|---|---|
| Asks for a secret | declares secret env var(s): MCP_AUTH_TOKEN | registry metadata | 2026-11-21 |
Known advisories for the published package SRC
An advisory existing does not mean the listed version is affected: compare the vulnerable range with the version you install. None found is not evidence of safety.
No advisories found
No published advisory matches a package this product declares. Products without a declared package cannot be matched at all. This is not evidence of safety.
Evaluation
Separate dimensions, each with its evidence. There is no overall score: the dimensions do not add up to one number honestly.
- Source authority
Publisher-submitted
Published to the official MCP Registry by the namespace owner. Field values are the publisher's own claims.
- Publisher verification
Namespace verified by registry
The MCP Registry verifies namespace ownership (GitHub login or DNS) before publishing. This confirms who published it, not what it does.
- Maintenance activity
Active
Last push 2026-11-20 (1 days before this page was built).
- Licence clarity
MIT
Licence identifier as reported by GitHub repository metadata.
- Installation clarity
Machine-readable
1 package(s) and 0 remote endpoint(s) declared in registry metadata.
- Documentation
Repository / website only
No dedicated documentation URL on record. AgentSidekick has not assessed documentation quality.
- Compatibility evidence
Protocol-level only
Compatibility is inferred from the standard it implements. No pairing has been tested.
- Security review
Not reviewed
AgentSidekick has not audited this product. 1 automated signal(s) are listed under Permissions & signals — they describe what it references, not whether it is safe.
Pricing
Not published in any source we track. The code is open source, which says nothing about the cost of any hosted service.
Repository activity
aliasunder/vault-cortex. Read from the GitHub API on 2026-11-21.
Version history SRC
- 1.0.0
- 0.57.8
- 0.57.7
- 0.57.6
- 0.57.5
- 0.57.4
- 0.57.3
- 0.57.2
32 earlier versions (the 40 most recent of 182 are listed)
- 0.57.1
- 0.57.0
- 0.56.5
- 0.56.4
- 0.56.3
- 0.56.2
- 0.56.1
- 0.56.0
- 0.55.5
- 0.55.4
- 0.55.3
- 0.55.2
- 0.55.1
- 0.55.0
- 0.54.16
- 0.54.15
- 0.54.14
- 0.54.13
- 0.54.12
- 0.54.11
- 0.54.10
- 0.54.9
- 0.54.8
- 0.54.7
- 0.54.6
- 0.54.5
- 0.54.4
- 0.54.3
- 0.54.2
- 0.54.1
- 0.54.0
- 0.53.0
Change history
What changed between two ingests of the same source, and when the product was first seen. Registry releases are under Version history.
- First seen
Competitors and alternativesDER
Paired by shared capabilities and integrations. Similar on paper; not tested side by side.
Direct
Same type, overlapping capabilities.
MCP serverby BatterWorksSRC
SharesSemantic SearchKnowledge Bases & WikisPersonal Knowledge ManagementNote-taking
MCP serverby byenzymeSRC
SharesSemantic SearchKnowledge Bases & WikisPersonal Knowledge ManagementNote-taking
MCP serverby oomkapwnSRC
SharesSimilarity SearchSemantic SearchKnowledge Bases & WikisPersonal Knowledge Management
MCP serverby flowing-abyssSRC
SharesSimilarity SearchSemantic SearchPersonal Knowledge ManagementNote-taking
MCP serverby pvliesdonkSRC
SharesSimilarity SearchSemantic SearchKnowledge Bases & WikisPersonal Knowledge Management
Adjacent
A different form or a partial overlap.
Agent skillby AgriciDanielSRC
SharesKnowledge Bases & WikisPersonal Knowledge ManagementNote-takingObsidian Vaults
Agent skillby AgriciDanielSRC
SharesKnowledge Bases & WikisPersonal Knowledge ManagementNote-takingObsidian Vaults
Agent skillby AgriciDanielSRC
SharesKnowledge Bases & WikisPersonal Knowledge ManagementNote-takingObsidian Vaults
Pluginby ccpluginsSRC
SharesKnowledge Bases & WikisPersonal Knowledge ManagementNote-takingObsidian Vaults
Agent skillby eugeniughelburHEU
SharesSemantic SearchKnowledge Bases & WikisPersonal Knowledge ManagementNote-taking
Provenance
Which source set each field, what kind of claim it is, and when.
| Field | Source | Kind | Set on |
|---|---|---|---|
| Canonical URL | Official MCP Registry | SRC | 2026-11-21 |
| Publisher | Official MCP Registry | SRC | 2026-11-21 |
| Description | Official MCP Registry | SRC | 2026-11-21 |
| Hosting | Official MCP Registry | SRC | 2026-11-21 |
| Integration type | Official MCP Registry | SRC | 2026-11-21 |
| Languages | GitHub repository metadata | SRC | 2026-11-21 |
| Latest version | Official MCP Registry | SRC | 2026-11-21 |
| Licence | GitHub repository metadata | SRC | 2026-11-21 |
| Name | Official MCP Registry | SRC | 2026-11-21 |
| Open source | GitHub repository metadata | DER | 2026-11-21 |
| Type | Official MCP Registry | SRC | 2026-11-21 |
| Published | Official MCP Registry | SRC | 2026-11-21 |
| Repository | Official MCP Registry | SRC | 2026-11-21 |
| source_updated_at | Official MCP Registry | SRC | 2026-11-21 |
| Source URL | Official MCP Registry | SRC | 2026-11-21 |
| Website | Official MCP Registry | SRC | 2026-11-21 |
Sources
- Official MCP Registry: registry.modelcontextprotocol.io (external)checked
Not verified by a researcher. Last seen in a source on . Report incorrect information