Dear Claude MCP Server
by sns45io.github.sns45/dear-claudev1.2.0
Spawn Claude Code instances from 6 platforms when 'Dear Claude' is mentioned.
context tax
queued
security
queued
cold start
queued
freshness
Maintained43d ago
Install Dear Claude MCP server
Install in Claude Code
claude mcp add dear-claude -e DEAR_CLAUDE_API_TOKEN='<dear-claude-api-token>' -e GITHUB_CLIENT_SECRET='<github-client-secret>' -e GITHUB_WEBHOOK_SECRET='<github-webhook-secret>' -e GITHUB_ACCESS_TOKEN='<github-access-token>' -e LINEAR_CLIENT_SECRET='<linear-client-secret>' -e LINEAR_WEBHOOK_SECRET='<linear-webhook-secret>' -e LINEAR_ACCESS_TOKEN='<linear-access-token>' -e JIRA_API_TOKEN='<jira-api-token>' -e JIRA_WEBHOOK_SECRET='<jira-webhook-secret>' -e GITLAB_ACCESS_TOKEN='<gitlab-access-token>' -e GITLAB_WEBHOOK_SECRET='<gitlab-webhook-secret>' -e NOTION_CLIENT_SECRET='<notion-client-secret>' -e NOTION_ACCESS_TOKEN='<notion-access-token>' -e NOTION_WEBHOOK_SECRET='<notion-webhook-secret>' -e GIPHY_API_KEY='<giphy-api-key>' -- npx -y dear-claudeInstall in Cursor
{
"mcpServers": {
"dear-claude": {
"command": "npx",
"args": [
"-y",
"dear-claude"
],
"env": {
"DEAR_CLAUDE_API_TOKEN": "<dear-claude-api-token>",
"GITHUB_CLIENT_SECRET": "<github-client-secret>",
"GITHUB_WEBHOOK_SECRET": "<github-webhook-secret>",
"GITHUB_ACCESS_TOKEN": "<github-access-token>",
"LINEAR_CLIENT_SECRET": "<linear-client-secret>",
"LINEAR_WEBHOOK_SECRET": "<linear-webhook-secret>",
"LINEAR_ACCESS_TOKEN": "<linear-access-token>",
"JIRA_API_TOKEN": "<jira-api-token>",
"JIRA_WEBHOOK_SECRET": "<jira-webhook-secret>",
"GITLAB_ACCESS_TOKEN": "<gitlab-access-token>",
"GITLAB_WEBHOOK_SECRET": "<gitlab-webhook-secret>",
"NOTION_CLIENT_SECRET": "<notion-client-secret>",
"NOTION_ACCESS_TOKEN": "<notion-access-token>",
"NOTION_WEBHOOK_SECRET": "<notion-webhook-secret>",
"GIPHY_API_KEY": "<giphy-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"dear-claude": {
"command": "npx",
"args": [
"-y",
"dear-claude"
],
"env": {
"DEAR_CLAUDE_API_TOKEN": "<dear-claude-api-token>",
"GITHUB_CLIENT_SECRET": "<github-client-secret>",
"GITHUB_WEBHOOK_SECRET": "<github-webhook-secret>",
"GITHUB_ACCESS_TOKEN": "<github-access-token>",
"LINEAR_CLIENT_SECRET": "<linear-client-secret>",
"LINEAR_WEBHOOK_SECRET": "<linear-webhook-secret>",
"LINEAR_ACCESS_TOKEN": "<linear-access-token>",
"JIRA_API_TOKEN": "<jira-api-token>",
"JIRA_WEBHOOK_SECRET": "<jira-webhook-secret>",
"GITLAB_ACCESS_TOKEN": "<gitlab-access-token>",
"GITLAB_WEBHOOK_SECRET": "<gitlab-webhook-secret>",
"NOTION_CLIENT_SECRET": "<notion-client-secret>",
"NOTION_ACCESS_TOKEN": "<notion-access-token>",
"NOTION_WEBHOOK_SECRET": "<notion-webhook-secret>",
"GIPHY_API_KEY": "<giphy-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"dear-claude": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"dear-claude"
],
"env": {
"DEAR_CLAUDE_API_TOKEN": "<dear-claude-api-token>",
"GITHUB_CLIENT_SECRET": "<github-client-secret>",
"GITHUB_WEBHOOK_SECRET": "<github-webhook-secret>",
"GITHUB_ACCESS_TOKEN": "<github-access-token>",
"LINEAR_CLIENT_SECRET": "<linear-client-secret>",
"LINEAR_WEBHOOK_SECRET": "<linear-webhook-secret>",
"LINEAR_ACCESS_TOKEN": "<linear-access-token>",
"JIRA_API_TOKEN": "<jira-api-token>",
"JIRA_WEBHOOK_SECRET": "<jira-webhook-secret>",
"GITLAB_ACCESS_TOKEN": "<gitlab-access-token>",
"GITLAB_WEBHOOK_SECRET": "<gitlab-webhook-secret>",
"NOTION_CLIENT_SECRET": "<notion-client-secret>",
"NOTION_ACCESS_TOKEN": "<notion-access-token>",
"NOTION_WEBHOOK_SECRET": "<notion-webhook-secret>",
"GIPHY_API_KEY": "<giphy-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"dear-claude": {
"command": "npx",
"args": [
"-y",
"dear-claude"
],
"env": {
"DEAR_CLAUDE_API_TOKEN": "<dear-claude-api-token>",
"GITHUB_CLIENT_SECRET": "<github-client-secret>",
"GITHUB_WEBHOOK_SECRET": "<github-webhook-secret>",
"GITHUB_ACCESS_TOKEN": "<github-access-token>",
"LINEAR_CLIENT_SECRET": "<linear-client-secret>",
"LINEAR_WEBHOOK_SECRET": "<linear-webhook-secret>",
"LINEAR_ACCESS_TOKEN": "<linear-access-token>",
"JIRA_API_TOKEN": "<jira-api-token>",
"JIRA_WEBHOOK_SECRET": "<jira-webhook-secret>",
"GITLAB_ACCESS_TOKEN": "<gitlab-access-token>",
"GITLAB_WEBHOOK_SECRET": "<gitlab-webhook-secret>",
"NOTION_CLIENT_SECRET": "<notion-client-secret>",
"NOTION_ACCESS_TOKEN": "<notion-access-token>",
"NOTION_WEBHOOK_SECRET": "<notion-webhook-secret>",
"GIPHY_API_KEY": "<giphy-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| 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 | — | yes | 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 | — | yes | GitHub OAuth App or GitHub App client secret |
| GITHUB_WEBHOOK_SECRET | — | yes | GitHub webhook signature secret |
| GITHUB_ACCESS_TOKEN | — | yes | 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 | — | yes | Linear OAuth application client secret |
| LINEAR_WEBHOOK_SECRET | — | yes | Linear webhook signing secret |
| LINEAR_ACCESS_TOKEN | — | yes | 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 | — | yes | Jira API token from id.atlassian.com |
| JIRA_WEBHOOK_SECRET | — | yes | Shared secret for Jira webhook URL validation |
| GITLAB_ACCESS_TOKEN | — | yes | GitLab personal or project access token |
| GITLAB_WEBHOOK_SECRET | — | yes | GitLab webhook secret token |
| NOTION_CLIENT_ID | — | — | Notion OAuth integration client ID |
| NOTION_CLIENT_SECRET | — | yes | Notion OAuth integration client secret |
| NOTION_ACCESS_TOKEN | — | yes | Notion internal integration token (alternative to OAuth) |
| NOTION_WEBHOOK_SECRET | — | yes | Notion webhook verification secret |
| OBSIDIAN_VAULT_PATH | — | — | Absolute path to Obsidian vault directory for file watching |
| GIPHY_API_KEY | — | yes | Giphy API key for embedding GIF reactions in responses |
Freshness
Maintained — last maintenance signal 43d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-27 · 43d ago · GitHub
Latest release
2026-08-27 · 43d ago · GitHub · v1.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-27 · 43d ago · official registry · v1.2.0
FAQ
›How do I install the Dear Claude MCP server in Claude Code?
Run: claude mcp add dear-claude -e DEAR_CLAUDE_API_TOKEN='<dear-claude-api-token>' -e GITHUB_CLIENT_SECRET='<github-client-secret>' -e GITHUB_WEBHOOK_SECRET='<github-webhook-secret>' -e GITHUB_ACCESS_TOKEN='<github-access-token>' -e LINEAR_CLIENT_SECRET='<linear-client-secret>' -e LINEAR_WEBHOOK_SECRET='<linear-webhook-secret>' -e LINEAR_ACCESS_TOKEN='<linear-access-token>' -e JIRA_API_TOKEN='<jira-api-token>' -e JIRA_WEBHOOK_SECRET='<jira-webhook-secret>' -e GITLAB_ACCESS_TOKEN='<gitlab-access-token>' -e GITLAB_WEBHOOK_SECRET='<gitlab-webhook-secret>' -e NOTION_CLIENT_SECRET='<notion-client-secret>' -e NOTION_ACCESS_TOKEN='<notion-access-token>' -e NOTION_WEBHOOK_SECRET='<notion-webhook-secret>' -e GIPHY_API_KEY='<giphy-api-key>' -- npx -y dear-claude. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Dear Claude require an API key?
Yes. It expects DEAR_CLAUDE_API_TOKEN, GITHUB_CLIENT_SECRET, GITHUB_WEBHOOK_SECRET, GITHUB_ACCESS_TOKEN, LINEAR_CLIENT_SECRET, LINEAR_WEBHOOK_SECRET, LINEAR_ACCESS_TOKEN, JIRA_API_TOKEN, JIRA_WEBHOOK_SECRET, GITLAB_ACCESS_TOKEN, GITLAB_WEBHOOK_SECRET, NOTION_CLIENT_SECRET, NOTION_ACCESS_TOKEN, NOTION_WEBHOOK_SECRET, GIPHY_API_KEY, of which 15 are secrets.
›Can I use Dear Claude as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Dear Claude in the official MCP registry?
Yes, as io.github.sns45/dear-claude.
Alternatives to Dear Claude
Other ai & llm tools MCP servers.