How do I use Dot MCP?

1. Click on "Install 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 - Send Notifications to Your Dot E-ink Device

NPM Version MIT licensed

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.

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

Dot MCP

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

开发

许可证

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API