neo4j-graphql-skill

What problem does it solve?

This Skill helps you turn a Neo4j graph into a production-ready GraphQL API using Neo4j GraphQL, so you can define types, relationships, custom Cypher resolvers, and authorization without hand-writing the entire API layer.

Core Features & Use Cases

• GraphQL typeDefs for Neo4j graphs: Model node types with @node and map fields to Neo4j labels/properties, including custom labels.
• Relationship modeling with directives: Define @relationship with correct IN/OUT/UNDIRECTED semantics and use relationship properties via @relationshipProperties and generated connection access.
• Custom resolvers with @cypher: Implement field-level and query-level resolvers safely within the GraphQL layer using @cypher and columnName alignment.
• Security with JWT/JWKS: Configure features.authorization.key, pass tokens through the Apollo context, and secure data with @authentication and @authorization using filter vs validate.
• Operational conveniences: Use assertIndexesAndConstraints to align @id with constraints, support subscriptions via CDC with features.subscriptions, and optionally use Apollo Federation patterns.
• OGM programmatic access: Use @neo4j/graphql OGM for server-side Neo4j access when you need bypassing GraphQL authorization for trusted workflows.

Quick Start

Install @neo4j/graphql and neo4j-driver, define your schema with @node/@relationship/@cypher and security directives, then construct Neo4jGraphQL with your driver and start an Apollo Server using neoSchema.getSchema().