Nouz

Semantic knowledge engine for Obsidian with auto-classification and DAG hierarchy

Connector by Semiotronika · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 24

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/semiotronika-nouz-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Semantic knowledge engine for Obsidian with auto-classification and DAG hierarchy

Use cases: knowledge-base, note-taking

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 7 read · 6 write · 0 delete · 5 not yet classified
Secrets: None asked for
Install scripts: None found
Runs as: Python package

Tools by what they do 18

Read from the source code; the running server may list different tools.

Read 7 · Look things up without changing anything.

get_children
get_parents
list_files
read_file
search_chunks
suggest_metadata
suggest_parents

Write 6 · Create, change, send or run things.

add_entity
calibrate_cores
chunk_text
recalc_signs
update_metadata
write_file

Not yet classified 5 · We could not tell from the name and description.

chunk_file
embed
index_all
process_orphans
recalc_core_mix

Secrets and settings it asks for

Other settings (environment variables or headers).

EMBED_API_URL
EMBED_ENABLED
EMBED_MODEL
EMBED_PROVIDER
NOUZ_CONFIG
NOUZ_DATABASE_NAME
NOUZ_DATABASE_PATH
OBSIDIAN_ROOT

Network hosts it talks to 2

github.com · found in code
glama.ai · found in code

Files it touches

Any path the agent passes to its tools

Tools (18)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

add_entity
Create a new knowledge-base entity as a Markdown file, then assign initial graph metadata. Use this for new notes when the agent has the content and should let NOUZ infer level, domain sign, and optional parent links. Tags are written only when passed explicitly. Set auto_parents=false when a human will choose parents manually. This writes a new file and returns the metadata that was applied.
calibrate_cores
Build or refresh reference embeddings for the semantic domains defined in config.yaml. Use this after creating a config, changing domain descriptions, or changing embedding models. It writes only to the local database, not to Markdown files. The result includes raw and mean-centered cosine similarities so you can see whether the configured domains are distinct enough for classification.
chunk_file
chunk_text
embed
get_children
Traverse the hierarchy downward from one note. Returns all direct and transitive child note paths from the local graph index. Use this to answer 'what does this topic/module contain?' It is read-only and does not recompute semantic classification. Use get_parents for the opposite direction.
get_parents
Return the parent links of one note from the graph index. Each result includes the parent entity name and link_type, such as hierarchy, derived_from, semantic, temporary, tag, analogy, or error. Use this to understand where a note belongs before editing links. It is read-only. Use suggest_parents when a note has no parents and you want candidate links.
index_all
list_files
List notes already known to the local index. Returns lightweight records with path, type, level, and sign, without loading full note bodies. Use this for inventory, filtering, and finding files to inspect next. Set no_metadata=true to find Markdown files without YAML metadata. Use get_children or get_parents when you need graph traversal from a specific note.
process_orphans
Batch-process notes that are missing key metadata. It can propose or write domain signs, material types, and parent links for newly created or orphaned Markdown files. Use dry_run=true first to review proposed changes. With dry_run=false this writes YAML frontmatter to files, so it should be used after inspection or on a trusted batch.
read_file
recalc_core_mix
Recalculate each higher-level node's domain composition from its children. This reveals structural drift: a module may be labeled as one domain while its child notes now mostly belong to another. Use after index_all with embeddings or after recalc_signs. It updates only the local database and does not modify Markdown YAML.
recalc_signs
search_chunks
suggest_metadata

Show 3 more tools

suggest_parents
Suggest parent notes for one note by vector similarity. Returns ranked candidates with scores so a human or agent can choose links for orphan or weakly connected notes. It never writes YAML and requires embeddings in PRIZMA/SLOI modes. Use get_parents to inspect existing links; use write_file only after you decide which parent links to keep.
update_metadata
Update only YAML frontmatter for an existing note and preserve the Markdown body exactly. Use this for safe changes to type, level, sign, artifact_sign, tags, parents, and parents_meta when the note content must not be touched.
write_file

Compare and alternatives

Featured in

Best MCP servers for Obsidian

Signals

Stars: 24
Forks: 0
Open issues: 0
Contributors: 1
Weekly downloads: 95
Last commit: Oct 16, 2026 (12 days ago)
Last release: Sep 2, 2026 (1 month ago)
Last package publish: Sep 2, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.Semiotronika/NOUZ-MCP
Version: 4.0.0
Auth: No auth
Packages: pypi nouz-mcp
License: MIT
Repository: github.com/Semiotronika/NOUZ-MCP
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql