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

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

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

Last updated: February 21, 2026

1 min read

Edit this page

Was this page helpful?