sns45 avatar

Dear Claude

sns45/dear-claude

This is a bidirectional bridge between project management tools and Claude Code instances. When you write "Dear Claude" in GitHub issues, Linear tasks, Jira tickets, GitLab merge requests, Notion pages, or Obsidian notes, it spawns a local Claude Code session with full context from that platform. The spawned instance can push code to GitHub, create Linear sub-tasks, post comments back to Jira, and access APIs across all six platforms simultaneously. It uses Tailscale Funnel for webhook delivery and keeps sessions alive for seven days to support multi-turn conversations. Useful if you want to turn issue comments into pull requests or orchestrate development tasks across multiple tools without copying context manually.

tools
8
auth
Secret needed
transport
STDIO
env vars
24
last updated
Aug 27, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

list_platformsList configured platforms and their status

List configured platforms and their status

No parameter schema in public metadata yet.

list_instancesList all Claude instances (filter by status)

List all Claude instances (filter by status)

No parameter schema in public metadata yet.

get_instance_statusGet detailed status of a specific instance

Get detailed status of a specific instance

No parameter schema in public metadata yet.

get_instance_messagesGet conversation history for an instance

Get conversation history for an instance

No parameter schema in public metadata yet.

kill_instanceTerminate a running instance

Terminate a running instance

No parameter schema in public metadata yet.

get_running_instancesList currently running instance IDs

List currently running instance IDs

No parameter schema in public metadata yet.

spawn_instanceSpawn a new Claude instance for a task

Spawn a new Claude instance for a task

No parameter schema in public metadata yet.

get_project_instancesList all instances in a project group

List all instances in a project group

No parameter schema in public metadata yet.

Sponsors

Configuration

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_TOKENsecret

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_SECRETsecret

GitHub OAuth App or GitHub App client secret

GITHUB_WEBHOOK_SECRETsecret

GitHub webhook signature secret

GITHUB_ACCESS_TOKENsecret

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_SECRETsecret

Linear OAuth application client secret

LINEAR_WEBHOOK_SECRETsecret

Linear webhook signing secret

LINEAR_ACCESS_TOKENsecret

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_TOKENsecret

Jira API token from id.atlassian.com

JIRA_WEBHOOK_SECRETsecret

Shared secret for Jira webhook URL validation

GITLAB_ACCESS_TOKENsecret

GitLab personal or project access token

GITLAB_WEBHOOK_SECRETsecret

GitLab webhook secret token

NOTION_CLIENT_ID

Notion OAuth integration client ID

NOTION_CLIENT_SECRETsecret

Notion OAuth integration client secret

NOTION_ACCESS_TOKENsecret

Notion internal integration token (alternative to OAuth)

Readme

Dear Claude - Just say Dear Claude

Dear Claude

MCP server that triggers local Claude Code instances from external platforms.
Say "Dear Claude" in Linear, GitHub, Jira, GitLab, Notion, or Obsidian — and a Claude Code instance spins up to handle it.

Your notes become architecture. Your tasks become pull requests.


What is this?

Dear Claude is an MCP (Model Context Protocol) server that watches your project management tools for the phrase "Dear Claude". When detected, it spawns a local Claude Code instance that:

  • Reads the issue/comment/note context
  • Executes the requested task (code, review, create tasks, etc.)
  • Posts results back to the originating platform
  • Persists sessions for 7 days so you can have multi-turn conversations

No Anthropic API keys needed. Works with your existing Claude Code subscription. 100% local and private — your code never leaves your machine.

Supported Platforms


View the full README on GitHub

Details

Repository
github.com/sns45/dear-claude
Package
dear-claude
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from sns45