AACFlow

Neo4j

Connect to Neo4j graph database

Usage Instructions

Integrate Neo4j graph database into the workflow. Can query, create, merge, update, and delete nodes and relationships.

Tools

neo4j_query

Execute MATCH queries to read nodes and relationships from Neo4j graph database. For best performance and to prevent large result sets, include LIMIT in your query (e.g.,

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description
cypherQuerystringYesCypher query to execute (e.g., "MATCH (n:Person) RETURN n LIMIT 10", "MATCH (a)-[r]->(b) WHERE a.name = $name RETURN a, r, b")
parametersobjectNoParameters for the Cypher query as a JSON object. Use for any dynamic values including LIMIT (e.g., query: "MATCH (n) RETURN n LIMIT $limit", parameters: {limit: 100}).

Output

ParameterTypeDescription
messagestringOperation status message
recordsarrayArray of records returned from the query
recordCountnumberNumber of records returned
summaryjsonQuery execution summary with timing and counters

neo4j_create

Execute CREATE statements to add new nodes and relationships to Neo4j graph database

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description
cypherQuerystringYesCypher CREATE statement to execute (e.g., "CREATE (n:Person {name: $name, age: $age})", "CREATE (a)-[:KNOWS]->(b)")
parametersobjectNoParameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "age": 30})

Output

ParameterTypeDescription
messagestringOperation status message
summaryjsonCreation summary with counters for nodes and relationships created

neo4j_merge

Execute MERGE statements to find or create nodes and relationships in Neo4j (upsert operation)

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description
cypherQuerystringYesCypher MERGE statement to execute (e.g., "MERGE (n:Person {name: $name}) ON CREATE SET n.created = timestamp()", "MERGE (a)-[r:KNOWS]->(b)")
parametersobjectNoParameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "email": "alice@example.com"})

Output

ParameterTypeDescription
messagestringOperation status message
summaryjsonMerge summary with counters for nodes/relationships created or matched

neo4j_update

Execute SET statements to update properties of existing nodes and relationships in Neo4j

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description
cypherQuerystringYesCypher query with MATCH and SET statements to update properties (e.g., "MATCH (n:Person {name: $name}) SET n.age = $age", "MATCH (n) WHERE n.id = $id SET n += $props")
parametersobjectNoParameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "age": 31, "props": {"city": "NYC"}})

Output

ParameterTypeDescription
messagestringOperation status message
summaryjsonUpdate summary with counters for properties set

neo4j_delete

Execute DELETE or DETACH DELETE statements to remove nodes and relationships from Neo4j

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description
cypherQuerystringYesCypher query with MATCH and DELETE/DETACH DELETE statements (e.g., "MATCH (n:Person {name: $name}) DELETE n", "MATCH (n) DETACH DELETE n")
parametersobjectNoParameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "id": 123})
detachbooleanNoNo description

Output

ParameterTypeDescription
messagestringOperation status message
summaryjsonDelete summary with counters for nodes and relationships deleted

neo4j_execute

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description
cypherQuerystringYesCypher query to execute (e.g., "CALL db.labels()", "MATCH (n) RETURN count(n)", "CREATE INDEX FOR (n:Person) ON (n.name)")
parametersobjectNoParameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "limit": 100})

Output

ParameterTypeDescription
messagestringOperation status message
recordsarrayArray of records returned from the query
recordCountnumberNumber of records returned
summaryjsonExecution summary with timing and counters

neo4j_introspect

Introspect a Neo4j database to discover its schema including node labels, relationship types, properties, constraints, and indexes.

Input

ParameterTypeRequiredDescription
hoststringYesNo description
portnumberYesNo description
databasestringYesDatabase name to connect to (e.g., "neo4j", "movies", "social")
usernamestringYesNo description
passwordstringYesNo description
encryptionstringNoNo description

Output

ParameterTypeDescription
messagestringOperation status message
labelsarrayArray of node labels in the database
relationshipTypesarrayArray of relationship types in the database
nodeSchemasarrayArray of node schemas with their properties
relationshipSchemasarrayArray of relationship schemas with their properties
constraintsarrayArray of database constraints
indexesarrayArray of database indexes

On this page

Start building today
Trusted by over 100,000 builders.
The SaaS platform to build AI agents and run your agentic workforce.
Get started