Skip to main content
Neo4J logo
  • Category: developer tools
  • Auth: OAUTH2, BASIC, API_KEY, S2S_OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 21
  • Triggers: 0
  • Slug: NEO4J
  • Version: 20261101_00

Tools

Slug: NEO4J_AGGREGATE_DIRECTORSExecutes a directorsAggregate GraphQL query to count directors in Neo4j. Use when you need to get the total count of director records in the database. The GraphQL query returns the count of all directors regardless of pagination.

Input Parameters

string
required
The unique identifier of the Neo4j Aura instance.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_CREATE_INSTANCE_BETACreates a new Neo4j Aura instance with the specified configuration. Use this action when you need to provision a new Neo4j Aura database instance. The operation is asynchronous - the API returns 202 Accepted while the instance is being created in the background. Use this action when you need to create a new Neo4j Aura database instance for your project. The returned credentials (username and password) should be stored securely as they cannot be retrieved again.

Input Parameters

string
required
The name of the instance (any UTF-8 characters with no trailing or leading whitespace). Max 30 characters.
string ("enterprise-db" | "enterprise-ds" | "business-critical" | "professional-db" | "professional-ds" | "free-db")
required
The type of the instance. Must be one of: enterprise-db, enterprise-ds, business-critical, professional-db, professional-ds, free-db. Please refer to your Aura projects instance configurations for valid types for your project.
string
required
The size of the instance memory in GB (e.g., ‘1GB’, ‘2GB’). Please refer to your Aura projects instance configurations for valid sizes for your project.
string
required
The region where the instance is hosted (e.g., ‘europe-west1’). Please refer to your Aura projects instance configurations for valid regions for your project.
string
The size of the instance storage in GB (e.g., ‘10GB’). Please refer to your Aura projects instance configurations for valid sizes for your project.
string
required
The Neo4j version of the instance (e.g., ‘5’). Please refer to your Aura projects instance configurations for valid versions for your project.
string
required
The ID for the project/tenant.
string ("gcp" | "aws" | "azure")
required
The cloud provider hosting the instance. Must be one of: gcp, aws, azure. Please refer to your Aura projects instance configurations for valid options for your project.
boolean
An optional vector optimization configuration to be set during instance creation.
string
The ID of the source instance when cloning.
string
An optional snapshot ID to create an instance from a specific snapshot. Requires source_instance_id to also be provided.
boolean
An optional graph analytics plugin configuration to be set during instance creation.
string
An optional customer managed key to be used for instance creation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_CREATE_SNAPSHOTCreate an on-demand snapshot of a Neo4j Aura instance, triggering backup creation and potentially returning a snapshot ID for monitoring progress. Use it to create a backup point before major changes or preserve the current database state.

Input Parameters

string
required
The unique identifier of the Neo4j Aura instance to snapshot.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_ESTIMATE_GDS_SESSION_SIZEEstimate the size of a new GDS (Graph Data Science) session based on node/relationship counts and algorithm categories. Use this action when you need to determine the appropriate GDS session size before creating a new graph analytics session. This helps ensure you provision sufficient memory for your graph workloads, particularly useful when planning memory allocation for large-scale graph operations like community detection, pathfinding, or similarity algorithms. The estimation considers the number of nodes, relationships, properties, and intended algorithm categories to provide accurate memory recommendations.

Input Parameters

integer
required
The number of nodes to be stored in the instance. Must be a non-negative integer.
integer
The number of labels per node. If not specified, the API will use a default estimate.
integer
required
The number of relationships to be stored in the instance. Must be a non-negative integer.
integer
The number of properties per node. If not specified, the API will use a default estimate.
array
The algorithm categories to be used in the session. Common categories include: ‘pathfinding’, ‘community_detection’, ‘centrality’, ‘similarity’, ‘link_prediction’. If not specified, the API uses a general-purpose estimate.
integer
The number of properties per relationship. If not specified, the API will use a default estimate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_GET_INSTANCE_BETARetrieves details for a specific Neo4j Aura instance using its unique instance ID. Returns comprehensive information including instance name, status, cloud provider, region, memory allocation, connection URL, and other configuration details. Use this action when you need to check the status, configuration, or connection details of a specific Neo4j Aura instance. This is a read-only operation that does not modify any instance state.

Input Parameters

string
required
The unique identifier of the Neo4j Aura instance to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_GET_ORGANIZATION_USERRetrieves details of a specific Neo4j Aura organization user, including email, organization roles, MFA status, last activity, and associated project IDs and names.

Input Parameters

string
required
The unique identifier of the user to retrieve
string
required
The unique identifier of the Aura organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_GET_PROJECTRetrieve details of a specific Neo4j Aura project (tenant). Returns project information including its ID, name, and available instance configurations with regions, types, memory, storage options, and cloud providers. Use this action when you need to inspect project details or discover available instance configurations before creating a new Aura instance.

Input Parameters

string
required
The unique identifier of the Aura project (tenant) to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_GET_PROJECT_BETARetrieve details of a specific Neo4j Aura project (tenant) using the v1beta5 API. Returns project information including its ID, name, and available instance configurations with regions, types, memory, storage options, and cloud providers. Use this action when you need to inspect project details or discover available instance configurations before creating a new Aura instance. This uses the v1beta5 API version which may have additional features compared to v1.

Input Parameters

string
required
The unique identifier of the Aura project (tenant) to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_GET_SNAPSHOTRetrieves details of a specific snapshot for a Neo4j Aura instance. Returns the snapshot profile, current status, and creation timestamp. Use this action when you need to check the status or details of a particular backup snapshot.

Input Parameters

string
required
The unique identifier of the Neo4j Aura instance
string
required
The unique identifier of the snapshot

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_AGENTSList all agents belonging to a specific Neo4j Aura project. Returns agent information including ID, name, description, database ID, privacy settings, endpoint links, MCP status, and attached tools. Use this action when you need to retrieve all agents for a specific project to identify available agents or to select a specific agent for subsequent operations.

Input Parameters

string
required
The unique identifier of the Aura project whose agents to list.
string
required
The unique identifier of the Aura organization whose agents to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_GDS_SESSIONSList all Graph Data Science (GDS) sessions for the authenticated Neo4j Aura account. Returns a summary of each GDS session including status, memory allocation, host information, and expiry date. Use optional filters (instanceId, tenantId, organizationId) to narrow down the results to specific instances or organizational units. Use this action when you need to: - Monitor active GDS sessions and their resource usage - Check session expiry dates to plan for renewals - View host connectivity information for GDS sessions - Audit GDS session creation and status across the organization This action is read-only and does not modify any resources.

Input Parameters

string
Filter GDS sessions by project/tenant ID. Returns sessions belonging to the specified project.
string
Filter GDS sessions by instance ID. Returns sessions for the specified Neo4j instance.
string
Filter GDS sessions by organization ID. Returns sessions belonging to the specified organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_INSTANCES_BETAReturns a list of Neo4j Aura instances. Use when you need to retrieve all available Neo4j Aura instances in your account, optionally filtered by tenant.

Input Parameters

string
An optional tenant ID to filter instances by tenant.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_IP_FILTERSReturns a list of IP filters configured for a Neo4j Aura organization. Use this action when you need to retrieve all IP filters to check which CIDR blocks are allowed or blocked, or to determine which resources are protected by IP filtering.

Input Parameters

string
required
The unique identifier of the organization whose IP filters to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_PROJECTSList all Aura projects (tenants) available to the authenticated user. Returns a summary of each project including its unique ID and name. Use this action when you need to retrieve all Aura projects to identify which projects are accessible or to select a specific project for subsequent operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_PROJECT_USERSList all users in a specific Neo4j Aura project. Returns user information including email, user ID, and project roles for each user. Use this action when you need to retrieve all users associated with a project to identify team members or verify user access levels.

Input Parameters

string
required
The unique identifier of the project
string
required
The unique identifier of the organization

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_LIST_SNAPSHOTSLists available snapshots for a Neo4j Aura instance. Returns both scheduled and ad-hoc snapshots with their status and creation timestamps. Use when you need to retrieve information about available database backups or recovery points for a specific Aura instance. The date parameter can filter results to a specific day.

Input Parameters

string
An optional date parameter to list snapshots for a given day, in YYYY-MM-DD format. Defaults to today if not specified.
string
required
The unique identifier of the Neo4j Aura instance to list snapshots for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_PAUSE_INSTANCE_BETAPauses a Neo4j Aura instance. Use when you need to temporarily stop an instance to reduce costs or perform maintenance. The instance can be resumed later using the ResumeInstance action. This action is asynchronous - the instance will be in a ‘pausing’ state until the operation completes. Note: this action cannot be performed if an ongoing operation (such as cloning) is in progress on the instance.

Input Parameters

string
required
The unique identifier of the Neo4j Aura instance to pause.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_RESTORE_SNAPSHOTRestore a Neo4j Aura instance from a snapshot. Replaces all current data with the snapshot data. This action is irreversible — all data since the snapshot was taken will be permanently lost. Use this action when you need to recover an Aura instance to a previous state from a specific snapshot. This operation cannot be undone once initiated.

Input Parameters

string
required
The unique identifier of the Neo4j Aura instance to restore.
string
required
The unique identifier of the snapshot to restore from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_UPDATE_INSTANCEUpdates a Neo4j Aura instance configuration. Allows modifying instance properties such as name, memory allocation, storage size, vector optimization, and graph analytics plugin. Use this action when you need to modify an existing Aura instance’s settings or resource allocation. Note: Some operations like memory or storage resizing may trigger an asynchronous update process where the instance status changes to ‘updating’. Check the instance status after making changes.

Input Parameters

string
Edit the instance name in the Aura Console. The name may include any UTF-8 characters with no trailing or leading whitespace.
string
The size of the instance memory in GB. Please refer to your Aura project instance configurations for valid sizes.
string
The size of the instance storage in GB. Please refer to your Aura project instance configurations for valid sizes. This field is NOT returned for Aura DB Free instances.
string
required
The unique identifier of the Neo4j Aura instance to update.
boolean
Add or remove the instance vector optimization.
boolean
Add or remove the instance graph analytics plugin.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_UPDATE_INSTANCE_BETAEdits the configuration of a Neo4j Aura instance. Allows updating the instance name, memory allocation, storage size, and plugin configurations. Use this action when you need to modify an existing Neo4j Aura instance’s settings such as renaming the instance, adjusting memory/storage resources, or enabling/disabling the graph analytics plugin or vector optimization features. Note: Some operations like resizing memory or storage may result in a 202 Accepted response indicating the resize request was accepted for async processing.

Input Parameters

string
Edit the instance name in the Aura Console. The name may include any UTF-8 characters with no trailing or leading whitespace.
string
The size of the instance memory in GB. Please refer to your Aura projects instance configurations for valid sizes.
string
The size of the instance storage in GB. Please refer to your Aura projects instance configurations for valid sizes.
string
required
The unique identifier of the Neo4j Aura instance to update.
boolean
Add or remove the instance vector optimization.
boolean
Add or remove the instance graph analytics plugin.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: NEO4J_UPDATE_IP_FILTERUpdates an existing IP filter for a Neo4j Aura organization. Use this action when you need to modify an existing IP filter’s settings, such as updating its name, description, allow list entries, or enabling/disabling the filter. The request body accepts partial updates - only include the fields you want to modify. This is an idempotent operation that updates the specified properties while preserving all other existing values.

Input Parameters

string
The new name for the IP filter
array
A list of CIDR entries to set for the IP filter allow list. Each entry must have an address and prefix_len. Optional description can also be provided.
string
The new description for the IP filter
string
required
The unique identifier of the IP filter to update
string
required
The unique identifier of the organization that owns the IP filter
boolean
Whether to disable IP filtering. Set to true to disable filtering or false to enable it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not