Connect Neo4j to Claude Code

Explore a Neo4j graph's labels, relationship types, properties, indexes and constraints, and run Cypher against it. Add Toolspoke to Claude Code once and it can use 9 Neo4j actions. Your Neo4j credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Neo4j and connect it

    Add Neo4j to a project in your Toolspoke workspace.

    User and password. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    HTTPS endpoint
    Aura: console.neo4j.io → Instances → your instance → Connection URI, with neo4j+s:// replaced by https://. Self-managed: the server's HTTP(S) connector, usually https://host:7473 or http://host:7474, reachable from the internet. No path.
    User and password
    The database user and its password joined by a colon, sent as HTTP Basic. Aura gives you these when the instance is created. Use a user with a read-only role unless you mean to grant the write action.
  3. Choose what Claude Code may do

    All 9 actions start on. Switch off the one action that changes something in Neo4j, and Claude Code gets a refusal if it tries.

What you can ask Claude Code for

A few of the Neo4j actions that only read, so they are safe to try first.

  • Report the Neo4j version and edition
  • List every node label in the database
  • List every relationship type in the database
  • List the properties found on each combination of node labels, with their types and whether every node has them

What Claude Code can do in Neo4j

8 actions read and one deletes or permanently changes something.

Reads

  • Server info

    Report the Neo4j version and edition. Call this first to confirm the connection, the credential and the database name all work.

  • List labels

    List every node label in the database.

  • List relationship types

    List every relationship type in the database.

  • Node properties

    List the properties found on each combination of node labels, with their types and whether every node has them. Use it to learn the graph's shape before writing a query. It samples the store, so it can be slow on a very large graph.

  • Relationship properties

    List the properties found on each relationship type, with their types and whether every relationship has them.

  • List indexes

    List the database's indexes, name, type, the labels or types and properties they cover, and whether each is online.

  • List constraints

    List the database's constraints, uniqueness, existence and key rules, with the labels and properties they apply to.

  • Run read query

    Run one read-only Cypher statement and return the rows. Pass values as `parameters` and refer to them as $name in the statement, never paste values into the Cypher. Sent in Read access mode, so a statement that writes is refused by the server. Include your own LIMIT.

Deletes or permanently changes

  • Run write query

    Run one Cypher statement that may write: CREATE, MERGE, SET, DELETE, or a schema command. Destructive because DETACH DELETE and DROP remove data with no undo. Pass values as `parameters`, never pasted into the Cypher.

Neo4j in Claude Code: questions

Does Claude Code see my Neo4j credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop Claude Code from changing things in Neo4j?

Yes. Each of the 9 actions can be switched off for a project. Turn off the one that changes something and Claude Code can only read.

Will 9 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Neo4j action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Neo4j call does not run in a sandbox, so it bills nothing.

Try Neo4j in Claude Code

Free to start, and tool calls cost nothing on any plan.