npm · dear-claude
$npx -y dear-claude@1.2.0 DEAR_CLAUDE_PORT — HTTP server port for webhooks (default: 3334)
DEAR_CLAUDE_HOST — Bind address for the HTTP server (default: 127.0.0.1, loopback only)
DEAR_CLAUDE_DATA_DIR — Override the data directory (default: $XDG_DATA_HOME/dear-claude or ~/.local/share/dear-claude)
DEAR_CLAUDE_API_TOKEN · secret — Token guarding the /api/* and /mcp control endpoints (auto-generated at <dataDir>/api-token if unset)
TAILSCALE_HOSTNAME — Override Tailscale hostname for webhook URLs (auto-detected if not set)
GITHUB_CLIENT_ID — GitHub OAuth App or GitHub App client ID
GITHUB_CLIENT_SECRET · secret — GitHub OAuth App or GitHub App client secret
GITHUB_WEBHOOK_SECRET · secret — GitHub webhook signature secret
GITHUB_ACCESS_TOKEN · secret — GitHub personal access token (alternative to OAuth)
GITHUB_APP_ID — GitHub App ID (for installation-based auth)
GITHUB_APP_PRIVATE_KEY_PATH — Path to GitHub App private key PEM file
LINEAR_CLIENT_ID — Linear OAuth application client ID
LINEAR_CLIENT_SECRET · secret — Linear OAuth application client secret
LINEAR_WEBHOOK_SECRET · secret — Linear webhook signing secret
LINEAR_ACCESS_TOKEN · secret — Linear personal API key (alternative to OAuth)
JIRA_DOMAIN — Jira Cloud domain (e.g. 'mycompany' for mycompany.atlassian.net)
JIRA_USER_EMAIL — Jira account email for API authentication
JIRA_API_TOKEN · secret — Jira API token from id.atlassian.com
JIRA_WEBHOOK_SECRET · secret — Shared secret for Jira webhook URL validation
GITLAB_ACCESS_TOKEN · secret — GitLab personal or project access token
GITLAB_WEBHOOK_SECRET · secret — GitLab webhook secret token
NOTION_CLIENT_ID — Notion OAuth integration client ID
NOTION_CLIENT_SECRET · secret — Notion OAuth integration client secret
NOTION_ACCESS_TOKEN · secret — Notion internal integration token (alternative to OAuth)
NOTION_WEBHOOK_SECRET · secret — Notion webhook verification secret
OBSIDIAN_VAULT_PATH — Absolute path to Obsidian vault directory for file watching
GIPHY_API_KEY · secret — Giphy API key for embedding GIF reactions in responses