Gives agents access to PostgreSQL, MySQL, SQLite, Oracle, SQL Server and more via SQLAlchemy, with schema inspection and queries.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add alchemy --env DB_URL='<DB_URL>' -- uvx --from mcp-alchemy==2025.6.19.201831 --refresh-package mcp-alchemy mcp-alchemy~/.codex/config.toml
[mcp_servers.alchemy]
command = "uvx"
args = ["--from", "mcp-alchemy==2025.6.19.201831", "--refresh-package", "mcp-alchemy", "mcp-alchemy"]
env = { DB_URL = "<DB_URL>" }
# codex mcp add alchemy --env DB_URL='<DB_URL>' -- uvx --from mcp-alchemy==2025.6.19.201831 --refresh-package mcp-alchemy mcp-alchemy~/.cursor/mcp.json
{
"mcpServers": {
"alchemy": {
"command": "uvx",
"args": [
"--from",
"mcp-alchemy==2025.6.19.201831",
"--refresh-package",
"mcp-alchemy",
"mcp-alchemy"
],
"env": {
"DB_URL": "<DB_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"alchemy": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"mcp-alchemy==2025.6.19.201831",
"--refresh-package",
"mcp-alchemy",
"mcp-alchemy"
],
"env": {
"DB_URL": "<DB_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"alchemy": {
"command": "uvx",
"args": [
"--from",
"mcp-alchemy==2025.6.19.201831",
"--refresh-package",
"mcp-alchemy",
"mcp-alchemy"
],
"env": {
"DB_URL": "<DB_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"alchemy": {
"command": "uvx",
"args": [
"--from",
"mcp-alchemy==2025.6.19.201831",
"--refresh-package",
"mcp-alchemy",
"mcp-alchemy"
],
"env": {
"DB_URL": "<DB_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"alchemy": {
"command": "uvx",
"args": [
"--from",
"mcp-alchemy==2025.6.19.201831",
"--refresh-package",
"mcp-alchemy",
"mcp-alchemy"
],
"env": {
"DB_URL": "<DB_URL>"
}
}
}
}Environment variables
DB_URL
Replace the placeholders with your own credentials and keep them out of version control.