Legacy Local Installation
The local npm package setup is retained for legacy environments that cannot connect to the hosted OAuth server. For new connections, use the hosted AnyDB MCP connection.
Requirements
You need:
- An AnyDB account
- The email address used for that account
- The Claude Desktop application
- Your AnyDB integration key
Get an integration key
- Log in to AnyDB.
- Click the user icon in the bottom-right corner.
- Open the Integration tab in the Profile dialog.
- Copy the API key.
warning
Keep your API key secure. Never commit it to version control or share it publicly.
Configure Claude Desktop
Add the service to the Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"anydb": {
"command": "npx",
"args": ["-y", "anydb-mcp-service@latest"],
"env": {
"ANYDB_DEFAULT_API_KEY": "your_api_key_here",
"ANYDB_DEFAULT_USER_EMAIL": "your_email@example.com",
"ANYDB_API_URL": "https://app.anydb.com/api"
}
}
}
}
Replace your_api_key_here and your_email@example.com with your AnyDB integration key and account email. Save the file, then fully quit and restart Claude Desktop.
Exact environment variable name
Use ANYDB_API_URL. Do not use ANYDB_API_BASE_URL; it is not recognized.
Configuration values
| Variable | Required | Description |
|---|---|---|
ANYDB_DEFAULT_API_KEY | Yes | Your AnyDB API key |
ANYDB_DEFAULT_USER_EMAIL | Yes | Email associated with your API key |
ANYDB_API_URL | No | API base URL; defaults to https://app.anydb.com/api |
Verify the local connection
After restarting Claude Desktop, ask:
Which AnyDB account am I connected as, and what teams can I access?
Troubleshooting
| Problem | Resolution |
|---|---|
| Authentication fails | Confirm the API key, email, and ANYDB_API_URL. |
| Configuration changes do not take effect | Fully quit and restart Claude Desktop. |
| Old package behavior remains | Keep @latest in the package argument and clear the relevant ~/.npm/_npx/ cache if needed. |
| Credentials are reported missing | Set both ANYDB_DEFAULT_API_KEY and ANYDB_DEFAULT_USER_EMAIL. |
Claude Desktop logs are available at:
- macOS:
~/Library/Logs/Claude/mcp*.log - Windows:
%APPDATA%\Claude\logs\mcp*.log