---
title: Configuration Reference
description: "Complete reference of all Mudabbir configuration options: environment variables with MUDABBIR_ prefix, JSON config fields, channel tokens, API keys, tool profiles, and memory backend settings."
section: API Reference
ogType: article
keywords: ["configuration", "environment variables", "settings reference", "config options"]
tags: ["api", "configuration"]
---

# Configuration Reference

Complete reference of all configuration settings. All environment variables use the `MUDABBIR_` prefix.

## Core Settings

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `anthropic_api_key` | `MUDABBIR_ANTHROPIC_API_KEY` | — | Anthropic API key |
| `openai_api_key` | `MUDABBIR_OPENAI_API_KEY` | — | OpenAI API key |
| `agent_backend` | `MUDABBIR_AGENT_BACKEND` | `claude_agent_sdk` | Agent backend |
| `claude_sdk_model` | `MUDABBIR_CLAUDE_SDK_MODEL` | `""` (auto) | Model override for Claude SDK (empty = let Claude Code decide) |
| `claude_sdk_max_turns` | `MUDABBIR_CLAUDE_SDK_MAX_TURNS` | `25` | Max tool-use turns per query in Claude SDK |
| `smart_routing_enabled` | `MUDABBIR_SMART_ROUTING_ENABLED` | `false` | Smart model routing (disabled by default — conflicts with Claude Code) |
| `model_tier_simple` | `MUDABBIR_MODEL_TIER_SIMPLE` | `claude-haiku-4-5-20251001` | Model for simple tasks (when smart routing is on) |
| `model_tier_moderate` | `MUDABBIR_MODEL_TIER_MODERATE` | `claude-sonnet-4-5-20250929` | Model for moderate tasks (when smart routing is on) |
| `model_tier_complex` | `MUDABBIR_MODEL_TIER_COMPLEX` | `claude-opus-4-6` | Model for complex tasks (when smart routing is on) |
| `web_host` | `MUDABBIR_WEB_HOST` | `127.0.0.1` | Dashboard bind address |
| `web_port` | `MUDABBIR_WEB_PORT` | `8888` | Dashboard port |

## LLM Provider

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `llm_provider` | `MUDABBIR_LLM_PROVIDER` | `auto` | LLM provider (`auto`, `anthropic`, `openai`, `ollama`) |
| `ollama_host` | `MUDABBIR_OLLAMA_HOST` | `http://localhost:11434` | Ollama server URL |
| `ollama_model` | `MUDABBIR_OLLAMA_MODEL` | `llama3.2` | Ollama model name |

When `llm_provider` is `auto`, Mudabbir uses Anthropic if an API key is set, otherwise falls back to Ollama.

## Tool Policy

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `tool_profile` | `MUDABBIR_TOOL_PROFILE` | `coding` | Tool profile |
| `tools_allow` | `MUDABBIR_TOOLS_ALLOW` | `[]` | Allowed tools |
| `tools_deny` | `MUDABBIR_TOOLS_DENY` | `[]` | Denied tools |

## Telegram

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `telegram_token` | `MUDABBIR_TELEGRAM_TOKEN` | — | Bot token |
| `allowed_telegram_ids` | `MUDABBIR_ALLOWED_TELEGRAM_IDS` | `[]` | Allowed user IDs |

## Discord

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `discord_bot_token` | `MUDABBIR_DISCORD_BOT_TOKEN` | — | Bot token |
| `discord_allowed_guild_ids` | `MUDABBIR_DISCORD_ALLOWED_GUILD_IDS` | `[]` | Allowed guilds |
| `discord_allowed_user_ids` | `MUDABBIR_DISCORD_ALLOWED_USER_IDS` | `[]` | Allowed users |

## Slack

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `slack_bot_token` | `MUDABBIR_SLACK_BOT_TOKEN` | — | Bot token (xoxb-) |
| `slack_app_token` | `MUDABBIR_SLACK_APP_TOKEN` | — | App token (xapp-) |
| `slack_allowed_channel_ids` | `MUDABBIR_SLACK_ALLOWED_CHANNEL_IDS` | `[]` | Allowed channels |

## WhatsApp

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `whatsapp_mode` | `MUDABBIR_WHATSAPP_MODE` | `business` | Mode (personal/business) |
| `whatsapp_access_token` | `MUDABBIR_WHATSAPP_ACCESS_TOKEN` | — | Business API token |
| `whatsapp_phone_number_id` | `MUDABBIR_WHATSAPP_PHONE_NUMBER_ID` | — | Phone number ID |
| `whatsapp_verify_token` | `MUDABBIR_WHATSAPP_VERIFY_TOKEN` | — | Webhook verify token |
| `whatsapp_allowed_phone_numbers` | `MUDABBIR_WHATSAPP_ALLOWED_PHONE_NUMBERS` | `[]` | Allowed numbers |
| `whatsapp_neonize_db` | `MUDABBIR_WHATSAPP_NEONIZE_DB` | `~/.mudabbir/neonize.db` | Neonize DB path |

## Signal

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `signal_api_url` | `MUDABBIR_SIGNAL_API_URL` | — | signal-cli REST API URL |
| `signal_phone_number` | `MUDABBIR_SIGNAL_PHONE_NUMBER` | — | Registered number |
| `signal_allowed_numbers` | `MUDABBIR_SIGNAL_ALLOWED_NUMBERS` | `[]` | Allowed numbers |

## Matrix

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `matrix_homeserver` | `MUDABBIR_MATRIX_HOMESERVER` | — | Homeserver URL |
| `matrix_user_id` | `MUDABBIR_MATRIX_USER_ID` | — | Bot user ID |
| `matrix_access_token` | `MUDABBIR_MATRIX_ACCESS_TOKEN` | — | Auth token |
| `matrix_device_id` | `MUDABBIR_MATRIX_DEVICE_ID` | — | Device ID |
| `matrix_allowed_room_ids` | `MUDABBIR_MATRIX_ALLOWED_ROOM_IDS` | `[]` | Allowed rooms |
| `matrix_display_name` | `MUDABBIR_MATRIX_DISPLAY_NAME` | — | Display name |

## Microsoft Teams

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `teams_app_id` | `MUDABBIR_TEAMS_APP_ID` | — | Bot Framework App ID |
| `teams_app_password` | `MUDABBIR_TEAMS_APP_PASSWORD` | — | App password |
| `teams_tenant_id` | `MUDABBIR_TEAMS_TENANT_ID` | — | Azure tenant ID |
| `teams_allowed_team_ids` | `MUDABBIR_TEAMS_ALLOWED_TEAM_IDS` | `[]` | Allowed teams |

## Google Chat

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `gchat_project_id` | `MUDABBIR_GCHAT_PROJECT_ID` | — | GCP project ID |
| `gchat_service_account_key` | `MUDABBIR_GCHAT_SERVICE_ACCOUNT_KEY` | — | SA key path |
| `gchat_mode` | `MUDABBIR_GCHAT_MODE` | `webhook` | Connection mode |
| `gchat_subscription` | `MUDABBIR_GCHAT_SUBSCRIPTION` | — | Pub/Sub subscription |
| `gchat_allowed_space_ids` | `MUDABBIR_GCHAT_ALLOWED_SPACE_IDS` | `[]` | Allowed spaces |

## Web Search

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `web_search_provider` | `MUDABBIR_WEB_SEARCH_PROVIDER` | `tavily` | Search provider |
| `tavily_api_key` | `MUDABBIR_TAVILY_API_KEY` | — | Tavily API key |
| `brave_search_api_key` | `MUDABBIR_BRAVE_SEARCH_API_KEY` | — | Brave Search key |

## Image Generation

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `google_api_key` | `MUDABBIR_GOOGLE_API_KEY` | — | Google AI API key |
| `image_model` | `MUDABBIR_IMAGE_MODEL` | `gemini-2.0-flash` | Model |

## Voice & STT

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `tts_provider` | `MUDABBIR_TTS_PROVIDER` | `openai` | TTS provider |
| `tts_voice` | `MUDABBIR_TTS_VOICE` | `alloy` | Voice ID |
| `elevenlabs_api_key` | `MUDABBIR_ELEVENLABS_API_KEY` | — | ElevenLabs key |
| `stt_model` | `MUDABBIR_STT_MODEL` | `whisper-1` | STT model |

## Google Integration

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `google_client_id` | `MUDABBIR_GOOGLE_CLIENT_ID` | — | OAuth client ID |
| `google_client_secret` | `MUDABBIR_GOOGLE_CLIENT_SECRET` | — | OAuth secret |

## Spotify

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `spotify_client_id` | `MUDABBIR_SPOTIFY_CLIENT_ID` | — | Spotify client ID |
| `spotify_client_secret` | `MUDABBIR_SPOTIFY_CLIENT_SECRET` | — | Spotify secret |

## MCP

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `mcp_client_metadata_url` | `MUDABBIR_MCP_CLIENT_METADATA_URL` | — | CIMD URL for MCP OAuth (for servers without dynamic client registration) |

## Memory (Mem0)

| Setting | Env Variable | Default | Description |
|---------|-------------|---------|-------------|
| `mem0_auto_learn` | `MUDABBIR_MEM0_AUTO_LEARN` | `false` | Enable auto-learn |
| `mem0_llm_provider` | `MUDABBIR_MEM0_LLM_PROVIDER` | `ollama` | LLM provider |
| `mem0_llm_model` | `MUDABBIR_MEM0_LLM_MODEL` | `llama3.2` | LLM model |
| `mem0_embedder_provider` | `MUDABBIR_MEM0_EMBEDDER_PROVIDER` | `ollama` | Embedder provider |
| `mem0_embedder_model` | `MUDABBIR_MEM0_EMBEDDER_MODEL` | `nomic-embed-text` | Embedder model |
| `mem0_vector_store` | `MUDABBIR_MEM0_VECTOR_STORE` | `qdrant` | Vector store |
