.env.example

# Things 3 MCP Server Configuration
# Copy this file to .env and customize the values as needed

# =============================================================================
# APPLESCRIPT EXECUTION
# =============================================================================

# AppleScript execution timeout in seconds (1-300)
THINGS_MCP_APPLESCRIPT_TIMEOUT=30.0

# Number of retries for failed operations (0-10)
THINGS_MCP_APPLESCRIPT_RETRY_COUNT=3

# =============================================================================
# THINGS URL SCHEME AUTHENTICATION
# =============================================================================

# Things 3 URL scheme requires an auth token for security
# You can provide your auth token in one of these ways:
#
# OPTION 1 (Recommended): Create a .things-auth file in the project root
#   echo "your-token-here" > .things-auth
#
# OPTION 2: Create things-auth.txt in the project root
#   echo "your-token-here" > things-auth.txt
#
# OPTION 3: Create ~/.things-auth in your home directory
#   echo "your-token-here" > ~/.things-auth
#
# The auth token is automatically loaded on startup and used for all
# URL scheme operations (checklist management, todo creation with checklists, etc.)
#
# To get your auth token, check Things 3 preferences or documentation

# =============================================================================
# TAG CREATION CONTROL
# =============================================================================

# Allow AI assistants to create new tags
# When false, AI can only use existing tags (human-only tag creation)
# When true, AI can create new tags as needed
THINGS_MCP_AI_CAN_CREATE_TAGS=false

# Enable case-sensitive tag validation
# When true, "Work" and "work" are treated as different tags
THINGS_MCP_TAG_VALIDATION_CASE_SENSITIVE=false

# Maximum number of tags that can be auto-created per operation (1-50)
# Prevents accidental creation of too many tags in bulk operations
THINGS_MCP_MAX_AUTO_CREATED_TAGS_PER_OPERATION=10

# Maximum number of tags per item (1-50)
THINGS_MCP_MAX_TAGS_PER_ITEM=20

# =============================================================================
# LOGGING
# =============================================================================

# Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL
THINGS_MCP_LOG_LEVEL=INFO

# Optional: Log to file instead of console
# Uncomment and set path to enable file logging
# THINGS_MCP_LOG_FILE_PATH=/var/log/things-mcp.log