Arangodb MCP Server

A Model Context Protocol Server for ArangoDB

Local serverstdioTypeScript

What is the Arangodb MCP server?

Most developer tooling work still happens through a UI a human drives. Arangodb MCP server moves it into the conversation instead. A Model Context Protocol Server for ArangoDB.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • arango_query — Query
  • arango_read_query — Query
  • arango_validate_query — Query
  • arango_explain_query — Query
  • arango_describe_database — Discovery
  • arango_list_collections — Discovery
  • arango_get_collection — Discovery
  • arango_create_collection — Collection
  • arango_drop_collection — Collection
  • arango_get_document — Document
  • arango_list_documents — Document
  • arango_count_documents — Document

Getting it running

Installation goes through your MCP client rather than a global install: point it at arango-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: ARANGO_URL, ARANGO_DB, ARANGO_USERNAME, ARANGO_PASSWORD. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Arangodb's toolset — arango_query, arango_read_query, arango_validate_query and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ravenwits; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Arangodb's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Arangodb.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
arango_queryQuery
arango_read_queryQuery
arango_validate_queryQuery
arango_explain_queryQuery
arango_describe_databaseDiscovery
arango_list_collectionsDiscovery
arango_get_collectionDiscovery
arango_create_collectionCollection
arango_drop_collectionCollection
arango_get_documentDocument
arango_list_documentsDocument
arango_count_documentsDocument
arango_sample_documentsDocument
arango_insertDocument

How to install the Arangodb MCP server

{
  "mcpServers": {
    "server-arangodb": {
      "command": "npx",
      "args": ["-y", "arango-server"],
      "env": {
        "ARANGO_URL": "your-value",
        "ARANGO_DB": "your-value",
        "ARANGO_USERNAME": "your-value",
        "ARANGO_PASSWORD": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
ARANGO_URLEndpoint or connection string the server talks to.Yes
ARANGO_DBConfiguration value read at startup.Optional
ARANGO_USERNAMEConfiguration value read at startup.Optional
ARANGO_PASSWORDConfiguration value read at startup.Optional

Example prompts to try

  • Use Arangodb to arango query.
  • Use Arangodb to arango read query.
  • Use Arangodb to arango validate query.

Frequently asked questions

It connects Arangodb to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (arango_query, arango_read_query, arango_validate_query, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Arangodb directly.