Dear Claude

io.github.sns45/dear-claude · v1.2.0

Spawn Claude Code instances from 6 platforms when 'Dear Claude' is mentioned.

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add dear-claude -e DEAR_CLAUDE_PORT=<DEAR_CLAUDE_PORT> -e DEAR_CLAUDE_HOST=<DEAR_CLAUDE_HOST> -e DEAR_CLAUDE_DATA_DIR=<DEAR_CLAUDE_DATA_DIR> -e DEAR_CLAUDE_API_TOKEN=<DEAR_CLAUDE_API_TOKEN> -e TAILSCALE_HOSTNAME=<TAILSCALE_HOSTNAME> -e GITHUB_CLIENT_ID=<GITHUB_CLIENT_ID> -e GITHUB_CLIENT_SECRET=<GITHUB_CLIENT_SECRET> -e GITHUB_WEBHOOK_SECRET=<GITHUB_WEBHOOK_SECRET> -e GITHUB_ACCESS_TOKEN=<GITHUB_ACCESS_TOKEN> -e GITHUB_APP_ID=<GITHUB_APP_ID> -e GITHUB_APP_PRIVATE_KEY_PATH=<GITHUB_APP_PRIVATE_KEY_PATH> -e LINEAR_CLIENT_ID=<LINEAR_CLIENT_ID> -e LINEAR_CLIENT_SECRET=<LINEAR_CLIENT_SECRET> -e LINEAR_WEBHOOK_SECRET=<LINEAR_WEBHOOK_SECRET> -e LINEAR_ACCESS_TOKEN=<LINEAR_ACCESS_TOKEN> -e JIRA_DOMAIN=<JIRA_DOMAIN> -e JIRA_USER_EMAIL=<JIRA_USER_EMAIL> -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_ID=<NOTION_CLIENT_ID> -e NOTION_CLIENT_SECRET=<NOTION_CLIENT_SECRET> -e NOTION_ACCESS_TOKEN=<NOTION_ACCESS_TOKEN> -e NOTION_WEBHOOK_SECRET=<NOTION_WEBHOOK_SECRET> -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -e GIPHY_API_KEY=<GIPHY_API_KEY> -- npx -y [email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "dear-claude": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "DEAR_CLAUDE_PORT": "<DEAR_CLAUDE_PORT>",
        "DEAR_CLAUDE_HOST": "<DEAR_CLAUDE_HOST>",
        "DEAR_CLAUDE_DATA_DIR": "<DEAR_CLAUDE_DATA_DIR>",
        "DEAR_CLAUDE_API_TOKEN": "<DEAR_CLAUDE_API_TOKEN>",
        "TAILSCALE_HOSTNAME": "<TAILSCALE_HOSTNAME>",
        "GITHUB_CLIENT_ID": "<GITHUB_CLIENT_ID>",
        "GITHUB_CLIENT_SECRET": "<GITHUB_CLIENT_SECRET>",
        "GITHUB_WEBHOOK_SECRET": "<GITHUB_WEBHOOK_SECRET>",
        "GITHUB_ACCESS_TOKEN": "<GITHUB_ACCESS_TOKEN>",
        "GITHUB_APP_ID": "<GITHUB_APP_ID>",
        "GITHUB_APP_PRIVATE_KEY_PATH": "<GITHUB_APP_PRIVATE_KEY_PATH>",
        "LINEAR_CLIENT_ID": "<LINEAR_CLIENT_ID>",
        "LINEAR_CLIENT_SECRET": "<LINEAR_CLIENT_SECRET>",
        "LINEAR_WEBHOOK_SECRET": "<LINEAR_WEBHOOK_SECRET>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "JIRA_DOMAIN": "<JIRA_DOMAIN>",
        "JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
        "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_ID": "<NOTION_CLIENT_ID>",
        "NOTION_CLIENT_SECRET": "<NOTION_CLIENT_SECRET>",
        "NOTION_ACCESS_TOKEN": "<NOTION_ACCESS_TOKEN>",
        "NOTION_WEBHOOK_SECRET": "<NOTION_WEBHOOK_SECRET>",
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "GIPHY_API_KEY": "<GIPHY_API_KEY>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "dear-claude": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "DEAR_CLAUDE_PORT": "<DEAR_CLAUDE_PORT>",
        "DEAR_CLAUDE_HOST": "<DEAR_CLAUDE_HOST>",
        "DEAR_CLAUDE_DATA_DIR": "<DEAR_CLAUDE_DATA_DIR>",
        "DEAR_CLAUDE_API_TOKEN": "<DEAR_CLAUDE_API_TOKEN>",
        "TAILSCALE_HOSTNAME": "<TAILSCALE_HOSTNAME>",
        "GITHUB_CLIENT_ID": "<GITHUB_CLIENT_ID>",
        "GITHUB_CLIENT_SECRET": "<GITHUB_CLIENT_SECRET>",
        "GITHUB_WEBHOOK_SECRET": "<GITHUB_WEBHOOK_SECRET>",
        "GITHUB_ACCESS_TOKEN": "<GITHUB_ACCESS_TOKEN>",
        "GITHUB_APP_ID": "<GITHUB_APP_ID>",
        "GITHUB_APP_PRIVATE_KEY_PATH": "<GITHUB_APP_PRIVATE_KEY_PATH>",
        "LINEAR_CLIENT_ID": "<LINEAR_CLIENT_ID>",
        "LINEAR_CLIENT_SECRET": "<LINEAR_CLIENT_SECRET>",
        "LINEAR_WEBHOOK_SECRET": "<LINEAR_WEBHOOK_SECRET>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "JIRA_DOMAIN": "<JIRA_DOMAIN>",
        "JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
        "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_ID": "<NOTION_CLIENT_ID>",
        "NOTION_CLIENT_SECRET": "<NOTION_CLIENT_SECRET>",
        "NOTION_ACCESS_TOKEN": "<NOTION_ACCESS_TOKEN>",
        "NOTION_WEBHOOK_SECRET": "<NOTION_WEBHOOK_SECRET>",
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "GIPHY_API_KEY": "<GIPHY_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "dear-claude": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "DEAR_CLAUDE_PORT": "<DEAR_CLAUDE_PORT>",
        "DEAR_CLAUDE_HOST": "<DEAR_CLAUDE_HOST>",
        "DEAR_CLAUDE_DATA_DIR": "<DEAR_CLAUDE_DATA_DIR>",
        "DEAR_CLAUDE_API_TOKEN": "<DEAR_CLAUDE_API_TOKEN>",
        "TAILSCALE_HOSTNAME": "<TAILSCALE_HOSTNAME>",
        "GITHUB_CLIENT_ID": "<GITHUB_CLIENT_ID>",
        "GITHUB_CLIENT_SECRET": "<GITHUB_CLIENT_SECRET>",
        "GITHUB_WEBHOOK_SECRET": "<GITHUB_WEBHOOK_SECRET>",
        "GITHUB_ACCESS_TOKEN": "<GITHUB_ACCESS_TOKEN>",
        "GITHUB_APP_ID": "<GITHUB_APP_ID>",
        "GITHUB_APP_PRIVATE_KEY_PATH": "<GITHUB_APP_PRIVATE_KEY_PATH>",
        "LINEAR_CLIENT_ID": "<LINEAR_CLIENT_ID>",
        "LINEAR_CLIENT_SECRET": "<LINEAR_CLIENT_SECRET>",
        "LINEAR_WEBHOOK_SECRET": "<LINEAR_WEBHOOK_SECRET>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "JIRA_DOMAIN": "<JIRA_DOMAIN>",
        "JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
        "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_ID": "<NOTION_CLIENT_ID>",
        "NOTION_CLIENT_SECRET": "<NOTION_CLIENT_SECRET>",
        "NOTION_ACCESS_TOKEN": "<NOTION_ACCESS_TOKEN>",
        "NOTION_WEBHOOK_SECRET": "<NOTION_WEBHOOK_SECRET>",
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "GIPHY_API_KEY": "<GIPHY_API_KEY>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

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

Details

Package	`[email protected]` (NPM, stdio)
First published	27 Aug 2026
Last updated	27 Aug 2026
Registry name	`io.github.sns45/dear-claude`

More developer tools servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Dear Claude often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-sns45-dear-claude/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-sns45-dear-claude)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.