neo4j-graphql-skill

Builds a GraphQL API backed by Neo4j using the @neo4j/graphql library.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/cardox6/steuer-graph --skill neo4j-graphql-skill-cardox6
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neo4j-graphql-skill
Source: https://github.com/cardox6/steuer-graph/tree/main/.agents/skills/neo4j-graphql-skill
Command: npx skills add https://github.com/cardox6/steuer-graph --skill neo4j-graphql-skill-cardox6

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @neo4j/graphql, neo4j-driver, graphql, @apollo/server, @neo4j/graphql-ogm.

What problem does it solve? Writing a GraphQL API over a Neo4j graph database by hand requires boilerplate resolvers, Cypher generation, and security wiring. This Skill guides an agent through the Neo4j GraphQL Library so type definitions, relationships, custom resolvers, and JWT authorization are configured correctly the first time. ## Core Features & Use Cases - Schema-Driven API Generation: Define types with @node, @relationship, @id, and @cypher directives and get auto-generated queries, mutations, and connection-based pagination. - Security Configuration: Set up @authentication and @authorization with JWT secrets or JWKS endpoints, choosing between filter (silent hiding) and validate (error-throwing) rules. - OGM and Subscriptions: Use the OGM for trusted server-side data access and enable CDC-backed subscriptions for real-time events. - Use Case: You have a Neo4j database of movies and actors. Use this Skill to generate a complete Apollo Server GraphQL API with relationship fields, a custom recommendation resolver via @cypher, and role-based authorization in minutes. ## Quick Start Ask the agent to create a Neo4j-backed GraphQL API with type definitions for your node labels and relationships, secured with JWT authorization.

Frequently Asked Questions about neo4j-graphql-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GraphQL API from a Neo4j database?▼

Install @neo4j/graphql, neo4j-driver, graphql, and @apollo/server, then define typeDefs with @node and @relationship directives. Pass them with a driver to the Neo4jGraphQL constructor, call getSchema(), and serve it through Apollo Server.

How do I write a custom resolver with the @cypher directive in Neo4j GraphQL?▼

Attach @cypher to a field with a statement and a columnName that exactly matches the RETURN alias. Use 'this' to reference the current node and pass field arguments as Cypher parameters like $limit.

What changed in @neo4j/graphql v7 compared to v6?▼

v7 requires @node on every node type, uses explicit { field: { eq: value } } filters, passes limit and sort as direct args instead of an options wrapper, and removes connectOrCreate, @private, and @unique. Relationship fields must be lists.

How do I secure Neo4j GraphQL fields with JWT authorization?▼

Configure features.authorization with a JWT secret or JWKS URL in the Neo4jGraphQL constructor and pass the token in the Apollo context. Then apply @authentication and @authorization directives, choosing filter to silently hide data or validate to throw errors.

Why does my @cypher field return null in Neo4j GraphQL?▼

The columnName argument does not match the RETURN alias in your Cypher statement, which silently yields null. Align both exactly, for example RETURN count(f) AS friendCount with columnName: "friendCount".

When should I not use the Neo4j GraphQL Library?▼

Avoid it for raw Cypher workloads outside GraphQL resolvers, where a direct driver or cypher-focused approach fits better, and for Java entity mapping, where Spring Data Neo4j is the appropriate tool. It also requires CDC in FULL mode for subscriptions.