Nouz MCP Server

Name: Nouz MCP Server
Author: io.github.Semiotronika

io.github.Semiotronika/NOUZ-MCP

Repository Registry

What is the Nouz MCP server?

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

How to install Nouz

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OBSIDIAN_ROOT
Path to Obsidian vault
NOUZ_CONFIG
Absolute path to config.yaml; if omitted, server looks in current working directory
NOUZ_DATABASE_NAME
SQLite cache filename inside OBSIDIAN_ROOT
NOUZ_DATABASE_PATH
Full SQLite cache path; takes precedence over NOUZ_DATABASE_NAME
EMBED_ENABLED
Enable embedding-based features
EMBED_PROVIDER
Embedding provider: openai-compatible endpoint or ollama
EMBED_MODEL
Embedding model name
EMBED_API_URL
Embedding API endpoint

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "NOUZ-MCP": {
      "command": "uvx",
      "args": [
        "nouz-mcp"
      ],
      "env": {
        "OBSIDIAN_ROOT": "<YOUR_OBSIDIAN_ROOT>",
        "NOUZ_CONFIG": "<YOUR_NOUZ_CONFIG>",
        "NOUZ_DATABASE_NAME": "<YOUR_NOUZ_DATABASE_NAME>",
        "NOUZ_DATABASE_PATH": "<YOUR_NOUZ_DATABASE_PATH>",
        "EMBED_ENABLED": "<YOUR_EMBED_ENABLED>",
        "EMBED_PROVIDER": "<YOUR_EMBED_PROVIDER>",
        "EMBED_MODEL": "<YOUR_EMBED_MODEL>",
        "EMBED_API_URL": "<YOUR_EMBED_API_URL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "NOUZ-MCP": {
      "command": "uvx",
      "args": [
        "nouz-mcp"
      ],
      "env": {
        "OBSIDIAN_ROOT": "<YOUR_OBSIDIAN_ROOT>",
        "NOUZ_CONFIG": "<YOUR_NOUZ_CONFIG>",
        "NOUZ_DATABASE_NAME": "<YOUR_NOUZ_DATABASE_NAME>",
        "NOUZ_DATABASE_PATH": "<YOUR_NOUZ_DATABASE_PATH>",
        "EMBED_ENABLED": "<YOUR_EMBED_ENABLED>",
        "EMBED_PROVIDER": "<YOUR_EMBED_PROVIDER>",
        "EMBED_MODEL": "<YOUR_EMBED_MODEL>",
        "EMBED_API_URL": "<YOUR_EMBED_API_URL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "NOUZ-MCP": {
      "command": "uvx",
      "args": [
        "nouz-mcp"
      ],
      "env": {
        "OBSIDIAN_ROOT": "<YOUR_OBSIDIAN_ROOT>",
        "NOUZ_CONFIG": "<YOUR_NOUZ_CONFIG>",
        "NOUZ_DATABASE_NAME": "<YOUR_NOUZ_DATABASE_NAME>",
        "NOUZ_DATABASE_PATH": "<YOUR_NOUZ_DATABASE_PATH>",
        "EMBED_ENABLED": "<YOUR_EMBED_ENABLED>",
        "EMBED_PROVIDER": "<YOUR_EMBED_PROVIDER>",
        "EMBED_MODEL": "<YOUR_EMBED_MODEL>",
        "EMBED_API_URL": "<YOUR_EMBED_API_URL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "NOUZ-MCP": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nouz-mcp"
      ],
      "env": {
        "OBSIDIAN_ROOT": "<YOUR_OBSIDIAN_ROOT>",
        "NOUZ_CONFIG": "<YOUR_NOUZ_CONFIG>",
        "NOUZ_DATABASE_NAME": "<YOUR_NOUZ_DATABASE_NAME>",
        "NOUZ_DATABASE_PATH": "<YOUR_NOUZ_DATABASE_PATH>",
        "EMBED_ENABLED": "<YOUR_EMBED_ENABLED>",
        "EMBED_PROVIDER": "<YOUR_EMBED_PROVIDER>",
        "EMBED_MODEL": "<YOUR_EMBED_MODEL>",
        "EMBED_API_URL": "<YOUR_EMBED_API_URL>"
      }
    }
  }
}

Claude Code

claude mcp add NOUZ-MCP --env OBSIDIAN_ROOT=<YOUR_OBSIDIAN_ROOT> --env NOUZ_CONFIG=<YOUR_NOUZ_CONFIG> --env NOUZ_DATABASE_NAME=<YOUR_NOUZ_DATABASE_NAME> --env NOUZ_DATABASE_PATH=<YOUR_NOUZ_DATABASE_PATH> --env EMBED_ENABLED=<YOUR_EMBED_ENABLED> --env EMBED_PROVIDER=<YOUR_EMBED_PROVIDER> --env EMBED_MODEL=<YOUR_EMBED_MODEL> --env EMBED_API_URL=<YOUR_EMBED_API_URL> -- uvx nouz-mcp

Related MCP servers

LINZA

Active

Local-first MCP sidecar for Markdown artifacts, review intents, and supervised knowledge growth.

Python

MIT

View repository →