FalkorDB MCP
Allows AI models to query and interact with FalkorDB graph databases through the Model Context Protocol (MCP) specification.
What is FalkorDB MCP?
FalkorDB MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to allows ai models to query and interact with falkordb graph databases through the model context protocol (mcp) specification.
Allows AI models to query and interact with FalkorDB graph databases through the Model Context Protocol (MCP) specification.
This server falls under the Databases and Data Science & ML categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Allows AI models to query and interact with FalkorDB graph d
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx falkordb-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use FalkorDB MCP
The FalkorDB MCP Server implements the Model Context Protocol to let AI assistants such as Claude query and manage FalkorDB graph databases using natural language. It translates conversational requests into OpenCypher queries, supports read-only mode for replica instances, exposes tools for listing graphs, creating and deleting nodes and relationships, and can run in either stdio mode for direct desktop integration or Streamable HTTP mode for networked deployments. Graph database developers and data engineers use it to explore knowledge graphs, run shortest-path analyses, and build or modify graph structures entirely through conversational AI.
Prerequisites
- Node.js 18 or higher
- A running FalkorDB instance (local via Docker or remote on FalkorDB Cloud)
- An MCP-compatible client such as Claude Desktop
- FALKORDB_HOST and FALKORDB_PORT environment variables (defaults: localhost and 6379)
- Optional: FALKORDB_USERNAME and FALKORDB_PASSWORD for authenticated instances
Start a FalkorDB instance
If you do not have a running FalkorDB instance, start one locally with Docker. FalkorDB listens on port 6379 by default.
docker run -p 6379:6379 falkordb/falkordb:latestAdd the server to your Claude Desktop configuration
Edit your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) to add the FalkorDB MCP server. The npx command pulls the latest published package automatically.
{
"mcpServers": {
"falkordb": {
"command": "npx",
"args": ["-y", "@falkordb/mcpserver@latest"],
"env": {
"FALKORDB_HOST": "localhost",
"FALKORDB_PORT": "6379",
"FALKORDB_USERNAME": "",
"FALKORDB_PASSWORD": ""
}
}
}
}Restart Claude Desktop
Quit and relaunch Claude Desktop. The FalkorDB tools (query_graph, query_graph_readonly, list_graphs, delete_graph) will appear in the tool list once the connection is established.
Optional: enable read-only mode for replicas
Set FALKORDB_DEFAULT_READONLY=true to ensure all queries use GRAPH.RO_QUERY. This is recommended when connecting to a read replica or in production environments where accidental writes must be prevented.
{
"mcpServers": {
"falkordb": {
"command": "npx",
"args": ["-y", "@falkordb/mcpserver@latest"],
"env": {
"FALKORDB_HOST": "replica.falkordb.com",
"FALKORDB_PORT": "6379",
"FALKORDB_USERNAME": "readonly_user",
"FALKORDB_PASSWORD": "secret",
"FALKORDB_DEFAULT_READONLY": "true"
}
}
}
}Optional: run in HTTP transport mode with Docker Compose
For networked or multi-client deployments, run both FalkorDB and the MCP server together using Docker Compose.
cp .env.example .env # set MCP_API_KEY, FALKORDB_PASSWORD, etc.
docker compose up -dFalkorDB MCP Examples
Client configuration
Claude Desktop configuration for a local FalkorDB instance using the official npm package.
{
"mcpServers": {
"falkordb": {
"command": "npx",
"args": ["-y", "@falkordb/mcpserver@latest"],
"env": {
"FALKORDB_HOST": "localhost",
"FALKORDB_PORT": "6379",
"FALKORDB_USERNAME": "",
"FALKORDB_PASSWORD": ""
}
}
}
}Prompts to try
Natural language prompts that translate to OpenCypher queries against a FalkorDB graph database.
- "List all available graphs in FalkorDB"
- "Create two Person nodes named Alice and Bob, then add a KNOWS relationship between them"
- "Show me all people who know each other in the social graph"
- "Find the shortest path between Alice and Charlie in the user_data graph"
- "What relationships does Alice have in the graph?"
- "Run a read-only query to count how many nodes are in the knowledge_base graph"Troubleshooting FalkorDB MCP
Connection refused — the server cannot reach FalkorDB
Verify FalkorDB is running with `docker ps` and that FALKORDB_HOST and FALKORDB_PORT match the running instance. If using Docker Desktop, use `host.docker.internal` instead of `localhost` for the host value.
Write queries fail with GRAPH.RO_QUERY error
You have FALKORDB_DEFAULT_READONLY set to true. Either set it to false in the env config, or use the query_graph tool with the readOnly parameter explicitly set to false for write operations.
npx hangs or times out on first run
The first run downloads the package from npm. Ensure you have internet access and npm is not behind a proxy that requires auth. You can pre-install with `npm install -g @falkordb/mcpserver` and change the command to `falkordb-mcpserver` with no npx args.
Frequently Asked Questions about FalkorDB MCP
What is FalkorDB MCP?
FalkorDB MCP is a Model Context Protocol (MCP) server that allows ai models to query and interact with falkordb graph databases through the model context protocol (mcp) specification. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install FalkorDB MCP?
Follow the installation instructions on the FalkorDB MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with FalkorDB MCP?
FalkorDB MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is FalkorDB MCP free to use?
Yes, FalkorDB MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
FalkorDB MCP Alternatives — Similar Databases Servers
Looking for alternatives to FalkorDB MCP? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up FalkorDB MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use FalkorDB MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.