How do I install the project synapse mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `WIKI_VAULT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Project Synapse MCP Server

Project Synapse is an MCP (Model Context Protocol) server that combines a Neo4j 2026.x graph database with an Obsidian Markdown wiki to create a

Local serverstdioPython

What is the Project Synapse MCP Server?

Project Synapse is an MCP (Model Context Protocol) server that combines a Neo4j 2026.x graph database with an Obsidian Markdown wiki to create a persistent

Configuration and credentials

Python 3.12+ - Neo4j 2026.x (Community or Enterprise) - uv package manager (pip install uv) - Obsidian with the Git community plugin - A GitHub repo for the wiki vault (can be private) - Node.js + defuddle (for web content fetching — see below)

Recorded tools

sentence — transformers** (default) — runs on GPU

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
ingest_text	Process text through semantic pipeline → Neo4j
query_knowledge	Vector semantic search with insight-first results
explore_connections	Graph traversal for hidden relationships
generate_insights	Autonomous Zettelkatten pattern detection
analyze_semantic_structure	Montague Grammar semantic analysis
wiki_fetch_url	Fetch URL → defuddle clean → ingest → archive to Clippings/
wiki_ingest_raw	Ingest file from raw/ → Neo4j + auto-move to Clippings/
wiki_write_page	Create/update wiki page with frontmatter (updates index write-through)
wiki_read_page	Read a wiki page by path supporting mode (meta, excerpt, full)
wiki_search	Keyword search across wiki pages returning excerpts and snippets
wiki_list_pages	List pages in a subdirectory with paginated limit, offset, and tag filters
wiki_update_index	Rebuild the wiki index (index.md)
wiki_sync_index	Manually sync/refresh the DuckDB page index database from disk
wiki_lint	Health check: orphans, broken links, missing/invalid frontmatter (runs via SQL)

How to install the Project Synapse MCP Server

{
  "mcpServers": {
    "project-synapse": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/project-synapse-mcp",
        "run",
        "python",
        "-m",
        "synapse_mcp.server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Python 3.12+ - Neo4j 2026.x (Community or Enterprise) - uv package manager (pip install uv) - Obsidian with the Git community plugin - A GitHub repo for the wiki vault (can be private) - Node.js + defuddle (for web content fetching — see below)

Example prompts to try

“Use Project Synapse MCP to sentence.”
“Use Project Synapse MCP to Prerequisites.”
“Use Project Synapse MCP to Installation.”

Frequently asked questions

Project Synapse is an MCP (Model Context Protocol) server that combines a Neo4j 2026.x graph database with an Obsidian Markdown wiki to create a persistent Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.