Delete File
Provides safe file deletion capabilities for AI assistants through MCP. Supports both relative and absolute file paths with smart path resolution.
File deletion capabilities to safely delete files when needed, with support for both relative and absolute paths.
What it does
- Delete files using relative paths
- Delete files using absolute paths
- Resolve multiple potential file paths automatically
- Check file existence before deletion
- Provide detailed error messages for failed deletions
Best for
About Delete File
Delete File is a community-built MCP server published by qpd-v that provides AI assistants with tools and capabilities via the Model Context Protocol. Safely delete files on Windows with support for all paths. Useful for Windows file recovery and effective disk clean up. It is categorized under file systems, developer tools. This server exposes 1 tool that AI clients can invoke during conversations and coding sessions.
How to install
You can install Delete File in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
Delete File is released under the Apache-2.0 license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (1)
Delete a file at the specified path (supports both relative and absolute paths)
@qpd-v/mcp-delete
A Model Context Protocol (MCP) server that provides file deletion capabilities. This server allows AI assistants to safely delete files when needed, with support for both relative and absolute paths.
Features
- Delete files using relative or absolute paths
- Smart path resolution that tries multiple potential paths
- Clear error messages with detailed path resolution information
- Safe file existence checks before deletion
- Works with Claude and other MCP-compatible AI assistants
Examples
Using with Claude Desktop
Using with VSCode Roo Cline Extension
Installation
Installing via Smithery
To install File Deletion for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @qpd-v/mcp-delete --client claude
Manual Installation
npx @qpd-v/mcp-delete
Or install globally:
npm install -g @qpd-v/mcp-delete
Configuration
Claude Desktop
Add the server configuration to your Claude Desktop config file:
Windows:
// %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
MacOS:
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
}
VSCode Extension
Add the server configuration to your Cline settings:
Windows:
// %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
MacOS:
// ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
}
Available Tools
delete_file
Deletes a file at the specified path.
Parameters:
path(string, required): Path to the file to delete (relative to working directory or absolute)
Example usage in Claude:
You can ask me to delete a file like this:
"Please delete the file example.txt"
I will use the delete_file tool to safely remove the file.
Path Resolution
The server intelligently handles path resolution by trying multiple approaches:
- The exact path as provided
- Path relative to the current working directory
- Path relative to a specified base directory
This makes it more user-friendly as files can be referenced by relative paths and the server will attempt to locate them correctly.
Development
Clone the repository:
git clone https://github.com/qpd-v/mcp-delete.git
cd mcp-delete
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. Use the MCP Inspector for debugging:
npm run inspector
This will provide a URL to access debugging tools in your browser.
License
MIT
Author
qpd-v
Alternatives
Related Skills
Browse all skillsThis skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.
Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.
Build document Q&A and searchable knowledge bases with Google Gemini File Search - fully managed RAG with automatic chunking, embeddings, and citations. Upload 100+ file formats (PDF, Word, Excel, code), configure semantic search, and query with natural language.Use when: building document Q&A systems, creating searchable knowledge bases, implementing semantic search without managing embeddings, indexing large document collections (100+ formats), or troubleshooting document immutability errors (delete+re-upload required), storage quota issues (3x input size for embeddings), chunking configuration (500 tokens/chunk recommended), metadata limits (20 key-value pairs max), indexing cost surprises ($0.15/1M tokens one-time), operation polling timeouts (wait for done: true), force delete errors, or model compatibility (Gemini 2.5 Pro/Flash only).
Answer questions about the AI SDK and help build AI-powered features. Use when developers: (1) Ask about AI SDK functions like generateText, streamText, ToolLoopAgent, embed, or tools, (2) Want to build AI agents, chatbots, RAG systems, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, Google, etc.), streaming, tool calling, structured output, or embeddings, (4) Use React hooks like useChat or useCompletion. Triggers on: "AI SDK", "Vercel AI SDK", "generateText", "streamText", "add AI to my app", "build an agent", "tool calling", "structured output", "useChat".
Comprehensive CrewAI framework guide for building collaborative AI agent teams and structured workflows. Use when developing multi-agent systems with CrewAI, creating autonomous AI crews, orchestrating flows, implementing agents with roles and tools, or building production-ready AI automation. Essential for developers building intelligent agent systems, task automation, and complex AI workflows.