wps-note

Read, search, and edit WPS Note documents via MCP tool calls.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/dy9759/SkillCollection --skill wps-note-dy9759
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wps-note
Source: https://github.com/dy9759/SkillCollection/tree/main/skills/wps-note
Command: npx skills add https://github.com/dy9759/SkillCollection --skill wps-note-dy9759

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provide reliable programmatic access to WPS Note content so users and agents can locate, read, and edit notes without manual navigation, avoiding token/ID mismatches and editor-state errors.

Core Features & Use Cases

  • Outline & Search-first Workflow: Locate content by note or block_id, then read sections or blocks to reduce token usage for large documents.
  • XML-based Read/Write with Safe Editing: Read and write content using semantic XML, perform atomic batch edits, insert images via dedicated tools, and enforce container nesting and tag rules.
  • Management & Diagnostics: Create, list, tag, sync, and permanently delete notes; retrieve audio transcripts and MCP logs to diagnose errors like BLOCK_NOT_FOUND and EDITOR_NOT_READY.
  • Use Case: Find a quarterly report by keyword, read the executive section, replace the summary paragraph, and append a conclusions heading in a single atomic transaction.

Quick Start

Open the Q1 report, locate the summary paragraph, and replace it with a concise 150-word executive summary.

Frequently Asked Questions about wps-note

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I programmatically edit WPS Note documents without manual navigation?

You can edit WPS Note documents programmatically through MCP tool calls that locate content by note_id or block_id and apply atomic batch edits, replacing paragraphs and appending headings in a single transaction.

Can I insert images and manage tags in WPS Notes using an automated workflow?

Yes, you can insert images and manage tags in WPS Notes using dedicated MCP tools. The workflow supports inserting images via insert_image calls and applying strict tag formatting rules for automated note management.

What is the best way to read large WPS Note documents without exceeding token limits?

The best way to read large WPS Note documents is using an outline and search-first workflow with pagination. Locate specific content by note or block_id, then read individual sections or blocks to significantly reduce token usage.

Does WPS Note MCP integration support XML-based content input and output?

Yes, WPS Note MCP integration fully supports XML-based block input and output. It enforces semantic XML read and write operations with strict container nesting rules for safe, structured note content editing.

Why does my WPS Note batch edit fail with BLOCK_NOT_FOUND or EDITOR_NOT_READY errors?

Batch edit failures with BLOCK_NOT_FOUND or EDITOR_NOT_READY errors occur when block IDs mismatch or the editor state is invalid. Retrieve MCP logs and audio transcripts to diagnose token mismatches and editor-state errors.

How do I search for a specific section in a WPS Note and replace its content step by step?

To search and replace content in a WPS Note, first locate the document by keyword, read the specific section using block_id, then apply an atomic batch_edit to replace the text and append new headings in a single ordered transaction.