Neo4j

Author: langgenius
Version: 0.0.1
Type: tool

Description

The Neo4j plugin enables Dify AI agents to interact with Neo4j graph databases. It provides tools for exploring database schemas, executing read and write Cypher queries, and discovering Graph Data Science (GDS) procedures for advanced analytics.

Features

Get Schema: Retrieve database structure including node labels, relationship types, property keys, indexes, and constraints
Read Cypher Query: Execute read-only Cypher queries safely with automatic write operation detection
Write Cypher Query: Execute write operations (CREATE, MERGE, SET, DELETE) with detailed statistics
List GDS Procedures: Discover available Graph Data Science algorithms for graph analytics

Installation

Install the plugin from the Dify Marketplace
Configure your Neo4j connection credentials:
- URI: Your Neo4j connection string (e.g., or )
- Username: Your Neo4j username (default is usually )
- Password: Your Neo4j password

Configuration

The plugin supports various Neo4j deployment types:

Deployment Type	URI Format
Local/Docker
Neo4j Aura
Self-hosted with TLS

Usage Examples

Get Database Schema

Use the "Get Schema" tool to understand your database structure before writing queries.

Read Data

Create Data

Create Relationships

Use GDS Algorithms

First, list available GDS procedures with a filter (e.g., "pagerank"), then execute the algorithm using write queries.

Troubleshooting

Issue	Solution
Connection refused	Check that Neo4j is running and the URI is correct
Authentication failed	Verify username and password
GDS not found	Install the Graph Data Science library on your Neo4j instance
Write operations blocked	Use the "Write Cypher Query" tool instead of "Read Cypher Query"

Security Best Practices

Use a dedicated Neo4j user with minimal required permissions
For read-only use cases, configure a user without write permissions
Consider using the read-only tool for exploratory queries
Review generated queries before executing write operations

Resources

License

This plugin is released under the same license as the Dify platform.