Manages and queries Turso databases with separate organization-level and database-level authentication.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add turso-cloud --env TURSO_API_TOKEN='<TURSO_API_TOKEN>' --env TURSO_ORGANIZATION='<TURSO_ORGANIZATION>' --env TURSO_DEFAULT_DATABASE='<TURSO_DEFAULT_DATABASE>' -- npx -y mcp-turso-cloud~/.codex/config.toml
[mcp_servers.turso-cloud]
command = "npx"
args = ["-y", "mcp-turso-cloud"]
env = { TURSO_API_TOKEN = "<TURSO_API_TOKEN>", TURSO_ORGANIZATION = "<TURSO_ORGANIZATION>", TURSO_DEFAULT_DATABASE = "<TURSO_DEFAULT_DATABASE>" }
# codex mcp add turso-cloud --env TURSO_API_TOKEN='<TURSO_API_TOKEN>' --env TURSO_ORGANIZATION='<TURSO_ORGANIZATION>' --env TURSO_DEFAULT_DATABASE='<TURSO_DEFAULT_DATABASE>' -- npx -y mcp-turso-cloud~/.cursor/mcp.json
{
"mcpServers": {
"turso-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-turso-cloud"
],
"env": {
"TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
"TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
"TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"turso-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-turso-cloud"
],
"env": {
"TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
"TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
"TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"turso-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-turso-cloud"
],
"env": {
"TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
"TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
"TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"turso-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-turso-cloud"
],
"env": {
"TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
"TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
"TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"turso-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-turso-cloud"
],
"env": {
"TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
"TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
"TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>"
}
}
}
}Environment variables
TURSO_API_TOKENTURSO_ORGANIZATIONTURSO_DEFAULT_DATABASE
Replace the placeholders with your own credentials and keep them out of version control.