Connect to Neo4j

Neo4j language guides

This section is designed to provide detailed examples of how to integrate Neo4j with your preferred programming language. Neo4j officially supports the drivers for .Net, Java, JavaScript, Go, and Python for the binary Bolt protocol.

Our community contributors provide drivers for all major programming languages for all protocols and APIs. In this section, we provide an introduction and a consistent example application for several languages and Neo4j drivers.

You should be familiar with graph database concepts and the property graph model. You should have created an Neo4j AuraDB cloud instance, or installed Neo4j locally.

Learn with GraphAcademy

We have a range of Neo4j Developer courses that teach you to build connect to Neo4j using each of our officially supported Drivers.

Building Neo4j Applications with Java Building Neo4j Applications with Node.js Building Neo4j Applications with Python Building Neo4j Applications with .NET Building Neo4j Applications with Go

How to connect to Neo4j?

If you’ve created an AuraDB instance, or installed and started Neo4j as a server on your system, you can already work interactively with the database via the built-in Neo4j Browser, which you find in the AuraDB console, or if you’re running locally, on localhost:7474.

To build an application, you want to connect to Neo4j from your technology stack, use a driver which connects to Neo4j via Bolt or HTTP.

The binary Bolt Protocol

Starting with Neo4j v3.0, we support a binary protocol called Bolt. It is based on the PackStream serialization and supports the Cypher® type system, protocol versioning, authentication, and TLS via certificates. For Neo4j Clusters, Bolt provides smart client routing with load balancing and failover.

The binary protocol is enabled in Neo4j by default, so you can use any language driver that supports it.

For more details on the protocol implementation, see the implementers documentation.

Neo4j Drivers

Neo4j provides official drivers for a number of popular programming languages. Below you can find links to their reference documentation:

Always use the latest version of the driver, as it will always work both with the previous Neo4j long-term support release and with the current and next major releases. The latest 5.x driver supports connection to any Neo4j 5 and 4.4 instance, and will also be compatible with Neo4j 6.

To demonstrate connection to and usage of Neo4j in different programming languages, an example application is created. It is a simple, one-page webapp, that uses Neo4j’s Movie demo database (movie, actor, director) as a dataset. The same front-end web page in all applications consumes three REST endpoints provided by backend implemented in the different programming languages and drivers:

  • movie search by title

  • single movie listing

  • graph visualization of the domain model

GitHub

The source code for all the different language examples is available on GitHub as individual repositories that can be cloned and directly used as starting points.

Using the HTTP API

The HTTP API is available in Community Edition and Enterprise Edition, but not in AuraDB.

If you want to access Neo4j programmatically, you can also use the HTTP API which enables you to:

  • POST one or more Cypher statements with parameters.

  • Keep transactions open over multiple requests.

  • Choose different result formats.

Let’s look at one of the underlying remote API endpoint that Neo4j offers to run queries. These APIs can be then used directly via a HTTP library or a driver for your language.

A simple HTTP Cypher request, executable in the Neo4j Browser, would look like this:

:POST /db/<database-name>/tx/commit {"statements":[
      {"statement":"CREATE (p:Person {firstName: $name}) RETURN p",
       "parameters":{"name":"Daniel"}}
    ]}

Some of the language drivers use the HTTP API under the hood, but make them available in a more convenient way.

Learn with GraphAcademy

Learn everything you need to know to build an application on top of Neo4j with free, hands-on courses from Neo4j GraphAcademy.