How do I use Dot MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Dot MCP send a notification with title 'Meeting' and message 'Starts in 5 minutes'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Dot MCP

by Lakphy

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

Dot MCP - Send Notifications to Your Dot E-ink Device

English | 中文

English

Introduction

Dot MCP is a Model Context Protocol (MCP) server that enables AI assistants to send notifications to your Dot e-ink display device. When AI completes tasks, encounters issues, or needs your attention, it can proactively notify you through your Dot device.

Related MCP server: Notifications MCP Server

Features

Send text notifications to Dot e-ink device
Support for title, message, signature, icon, and link
Immediate refresh or scheduled display
Proactive notifications from AI assistants

Requirements

Node.js >= v18.0.0
A Dot device, API key and Device ID (How to get API key and Device ID)
An MCP-compatible client (Cursor, Claude Code, VS Code, Windsurf, etc.)

Installation

Install in Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Add the following configuration to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Install in Claude Code

Run this command:

claude mcp add dot -- npx -y mindreset-dot-mcp --api-key YOUR_API_KEY --device-id YOUR_DEVICE_ID

Install in VS Code

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

{
  "mcp": {
    "servers": {
      "dot": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mindreset-dot-mcp",
          "--api-key",
          "YOUR_API_KEY",
          "--device-id",
          "YOUR_DEVICE_ID"
        ]
      }
    }
  }
}

Install in Windsurf

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Install in Cline

Open Cline MCP settings and add the following configuration:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Install in Claude Desktop

Open Claude Desktop developer settings and edit your claude_desktop_config.json:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "YOUR_API_KEY",
        "--device-id",
        "YOUR_DEVICE_ID"
      ]
    }
  }
}

Using Environment Variables

You can also use environment variables instead of CLI arguments:

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": ["-y", "mindreset-dot-mcp"],
      "env": {
        "DOT_API_KEY": "YOUR_API_KEY",
        "DOT_DEVICE_ID": "YOUR_DEVICE_ID"
      }
    }
  }
}

Available Tool

send_text

Send text content to your Dot e-ink device.

Parameters:

Parameter	Type	Required	Description
title	string	No	Text title displayed on the screen (max 10 Chinese characters)
message	string	No	Text content displayed on the screen (max 40 Chinese characters)
signature	string	No	Text signature displayed on the screen
icon	string	No	Base64 encoded PNG icon data (40x40px), displayed in the bottom left
link	string	No	HTTP/HTTPS link or Scheme URL for tap-to-open functionality
refreshNow	boolean	No	Whether to display content immediately (default: true)

Development

# Install dependencies
pnpm install

# Build
pnpm run build

# Run tests
pnpm run test

License

MIT

中文

简介

Dot MCP 是一个 Model Context Protocol (MCP) 服务器，可以让 AI 助手向你的 Dot 墨水屏设备发送通知。当 AI 完成任务、遇到问题或需要你的注意时，它可以主动通过你的 Dot 设备通知你。

功能特性

向 Dot 墨水屏设备发送文本通知
支持标题、消息、签名、图标和链接
即时刷新或定时显示
AI 助手主动通知

系统要求

Node.js >= v18.0.0
Dot 设备、API 密钥和设备 ID（如何获取 API 密钥和设备 ID）
支持 MCP 的客户端（Cursor、Claude Code、VS Code、Windsurf 等）

安装配置

在 Cursor 中安装

进入: Settings -> Cursor Settings -> MCP -> Add new global MCP server

在 ~/.cursor/mcp.json 中添加以下配置：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

在 Claude Code 中安装

运行以下命令：

claude mcp add dot -- npx -y mindreset-dot-mcp --api-key 你的API密钥 --device-id 你的设备ID

在 VS Code 中安装

将以下配置添加到 VS Code MCP 配置文件中。详见 VS Code MCP 文档。

{
  "mcp": {
    "servers": {
      "dot": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mindreset-dot-mcp",
          "--api-key",
          "你的API密钥",
          "--device-id",
          "你的设备ID"
        ]
      }
    }
  }
}

在 Windsurf 中安装

将以下配置添加到 Windsurf MCP 配置文件中。详见 Windsurf MCP 文档。

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

在 Cline 中安装

打开 Cline MCP 设置并添加以下配置：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

在 Claude Desktop 中安装

打开 Claude Desktop 开发者设置并编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": [
        "-y",
        "mindreset-dot-mcp",
        "--api-key",
        "你的API密钥",
        "--device-id",
        "你的设备ID"
      ]
    }
  }
}

使用环境变量

你也可以使用环境变量代替命令行参数：

{
  "mcpServers": {
    "dot": {
      "command": "npx",
      "args": ["-y", "mindreset-dot-mcp"],
      "env": {
        "DOT_API_KEY": "你的API密钥",
        "DOT_DEVICE_ID": "你的设备ID"
      }
    }
  }
}

可用工具

send_text

向 Dot 墨水屏设备发送文本内容。

参数：

参数	类型	必填	描述
title	string	否	屏幕上显示的标题（最多 10 个中文字符显示长度）
message	string	否	屏幕上显示的内容（最多 40 个中文字符显示长度）
signature	string	否	屏幕上显示的签名
icon	string	否	Base64 编码的 PNG 图标（40x40 像素），显示在左下角
link	string	否	HTTP/HTTPS 链接或 Scheme URL，点击可打开
refreshNow	boolean	否	是否立即显示内容（默认：true）

开发

# 安装依赖
pnpm install

# 构建
pnpm run build

# 运行测试
pnpm run test

许可证

MIT

Available Tools

1 tool

send_textSend Text to Dot DeviceA

Send text content to a Dot device (an e-ink display device). The text will be displayed on the e-ink screen.

You should PROACTIVELY call this tool to notify the user when:

You have completed a task (e.g., finished writing code, fixed a bug, completed a refactor)
You encounter an important issue that needs user attention
You want to remind the user about something important
A long-running task has finished

IMPORTANT: When you PROACTIVELY send a notification (not requested by user), you MUST include your name/identity in the signature field.

NOTE: If the request fails, retry once as it may be a temporary API issue.

Example: After completing a coding task, call this tool with title "Task Completed", message "I've finished implementing the feature you requested. Please review the changes.", and signature with your name (if proactively notifying) to notify the user on their Dot device.

Inputs: title, message, signature, icon, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored 2026-04-18 07:01 across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'send_text' has a clear and distinct purpose of sending text to a Dot device, leaving no room for misselection by an agent.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect. The tool name 'send_text' follows a clear verb_noun pattern, and there are no other tools to create inconsistency or mixed conventions.

Tool Count2/5

A single tool is too few for a server's purpose, as it limits functionality to basic notifications without supporting other potential operations like device management or status checks. This feels thin and incomplete for a device interaction domain.

Completeness2/5

The tool surface is severely incomplete for interacting with an e-ink display device. While 'send_text' covers notification sending, there are obvious gaps such as retrieving device status, managing display settings, or handling other device-specific operations, which could lead to agent failures in broader tasks.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

kweenkl-mcpA
io.github.antoinedelorme
Push notifications for AI agents - send instant iPhone notifications from any MCP client.
Communication App Automation
62
https://api.kweenkl.com/mcp
TRMNLA
com.trmnl
Run your TRMNL ePaper (e-ink) displays from any AI agent: devices, playlists and new screens.
Workplace & Productivity
221
https://trmnl.com/mcp
SenderKitA
com.senderkit
Build and send email, SMS, and push straight from your AI agent.
Email Communication
1831
https://mcp.senderkit.com
AgentPing
io.github.Noriget
Let your AI agent notify you by email, Slack, Discord, or webhook. One tool: send_notification.
Communication Email
2
https://ping.mgm-llc.org/mcp

Related MCP Servers

kweenkl MCP Server
Communication App Automation
antoinedelorme
A
license
B
quality
D
maintenance
Enables AI assistants to send push notifications through the kweenkl service. Allows users to receive contextual notifications from their AI when tasks are complete or important events occur.
Updated 5 months ago (2026-06-05 21:05 UTC)
1
9 npm
MIT
Notifications MCP Server
OS Automation App Automation
ohqay
A
license
Not graded
quality
D
maintenance
Enables AI assistants to send native macOS notifications for task completion alerts and reminders. Supports interactive features like custom system sounds, action buttons, and user replies directly from the notification center.
Updated a year ago (2025-06-19 02:30 UTC)
201 npm
MIT
BotBell MCP Server
Communication App Automation
qq418716640
A
license
A
quality
D
maintenance
Enables AI assistants to send push notifications and interactive alerts to iPhone and Mac devices via the BotBell app. It allows AI to receive user replies and manage notification bots for tasks like alerts, reminders, and remote approvals.
Updated 8 months ago (2026-03-23 15:08 UTC)
2
18 npm
1
MIT
MCPing
OS Automation
toolprint
A
license
B
quality
D
maintenance
Enables AI assistants to send desktop notifications on macOS with rich formatting, urgency levels, and sound options.
Updated a year ago (2025-07-21 21:32 UTC)
1
28 npm
1
MIT

Dot MCP - Send Notifications to Your Dot E-ink Device

English

Introduction

Features

Requirements

Installation

Install in Cursor

Install in Claude Code

Install in VS Code

Install in Windsurf

Install in Cline

Install in Claude Desktop

Using Environment Variables

Available Tool

send_text

Development

License

中文

简介

功能特性

系统要求

安装配置

在 Cursor 中安装

在 Claude Code 中安装

在 VS Code 中安装

在 Windsurf 中安装

在 Cline 中安装

在 Claude Desktop 中安装

使用环境变量

可用工具

send_text

开发

许可证

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

kweenkl MCP Server

Notifications MCP Server

BotBell MCP Server

MCPing