Dear Claude

Provides a self-contained MCP server that triggers local Claude Code instances from external platforms, executing tasks and returning results privately.

typescript

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sns45-dear-claude": {
      "command": "bunx",
      "args": [
        "dear-claude",
        "start",
        "--mcp"
      ],
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "JIRA_DOMAIN": "...",
        "JIRA_API_TOKEN": "...",
        "JIRA_USER_EMAIL": "...",
        "DEAR_CLAUDE_PORT": "3334",
        "GITHUB_CLIENT_ID": "...",
        "LINEAR_CLIENT_ID": "...",
        "NOTION_CLIENT_ID": "...",
        "GITLAB_ACCESS_TOKEN": "...",
        "JIRA_WEBHOOK_SECRET": "...",
        "LINEAR_ACCESS_TOKEN": "...",
        "NOTION_ACCESS_TOKEN": "...",
        "OBSIDIAN_VAULT_PATH": "/path/to/vault",
        "GITHUB_CLIENT_SECRET": "...",
        "LINEAR_CLIENT_SECRET": "...",
        "NOTION_CLIENT_SECRET": "...",
        "GITHUB_WEBHOOK_SECRET": "...",
        "GITLAB_WEBHOOK_SECRET": "...",
        "LINEAR_WEBHOOK_SECRET": "...",
        "NOTION_WEBHOOK_SECRET": "...",
        "OBSIDIAN_WATCH_DEBOUNCE_MS": "2000"
      }
    }
  }
}

The Dear Claude MCP Server watches your external platforms for the trigger phrase and spins up local Claude Code instances to read context, execute requests, and post results back, all while maintaining private, self-contained sessions for multi-turn conversations.

How to use

You will use an MCP client to connect to the Dear Claude MCP Server and trigger Claude Code instances from your project management tools. When you write the exact trigger phrase Dear Claude in a supported platform, a dedicated Claude Code instance starts, reads the surrounding context, performs the requested task, and posts the results back to the originating platform. Instances can spawn child instances for parallel tasks, and conversations are persisted for seven days.

How to install

Prerequisites ensure your environment can run the Dear Claude MCP Server and Claude Code.

Install the server using the one-line setup below. It starts the MCP server and prepares Claude Code for immediate use.

claude mcp add dear-claude -- bunx dear-claude start --mcp

Additional setup steps

Prerequisites you need before starting the server are listed here so you can verify they are present on your system.

Available tools

list_platforms

List configured platforms and their status within the MCP server

list_instances

List all Claude instances along with their statuses and metadata

get_instance_status

Retrieve detailed status information for a specific instance, including progress and results

get_instance_messages

Fetch the conversation history and messages for an instance

kill_instance

Terminate a running Claude instance gracefully

get_running_instances

Enumerate currently active Claude instances by identifier

spawn_instance

Create a new Claude instance to handle a given task or task set

get_project_instances

List all instances associated with a particular project group

Built by

VeilStrat

AI signals for GTM teams