pdf-organizer-mcp
This server automatically organizes PDF files into date-based folders. Here's what it can do:
Organize a single PDF (
organize_pdf) – Move or copy a PDF into a date-named folder (e.g.,2025-06-12) under a root directory, with an optional date override.Batch organize a directory (
organize_directory) – Move or copy all PDFs in a directory into a today's (or overridden) date folder, with optional recursive subdirectory scanning.Organize by file date (
organize_by_file_date) – Sort PDFs into folders based on each file's own modification or creation date, rather than today's date.List date folders (
list_date_folders) – Display all date-named folders in a root directory along with the PDF count in each.List PDFs in a folder (
list_pdfs_in_folder) – View PDFs inside a specific date folder; supportsYYYY-MM-DDor"오늘"(today).View history (
get_history) – Retrieve a configurable number of recent organization actions.
Key features: automatic folder creation, duplicate filename handling (file.pdf → file(1).pdf), copy mode to preserve originals, and persistent history stored in .air/data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pdf-organizer-mcp Organize ~/Downloads/report.pdf into ~/Documents/PDFs with today's date"
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.
pdf-organizer-mcp
Air 프레임워크(https://docs.airmcp.dev/) 로 만든
PDF 파일을 날짜별 폴더로 자동 정리하는 MCP 서버입니다.
다운로드한 PDF가 쌓일 때마다 지정한 기준에 걸맞는 날짜 형식의 폴더에 깔끔하게 분류됩니다.
설치 및 실행
npm install
npm run buildRelated MCP server: PDF Tools MCP Server
Claude Desktop 연결
claude_desktop_config.json에 아래 항목 추가:
{
"mcpServers": {
"pdf-organizer": {
"command": "node",
"args": ["/절대경로/pdf-organizer-mcp/dist/index.js"]
}
}
}제공 툴 5가지
툴 이름 | 설명 |
| PDF 파일 1개를 오늘 날짜 폴더로 이동/복사 |
| 디렉토리 내 모든 PDF를 일괄 정리 |
| 날짜 폴더 목록 + PDF 개수 조회 |
| 특정 날짜 폴더의 PDF 목록 조회 |
| 최근 정리 이력 조회 |
사용 예시 (Claude에게 말하기)
"~/Downloads/report.pdf 를 ~/Documents/PDFs 폴더에 오늘 날짜로 정리해줘"
→ organize_pdf 호출 → ~/Documents/PDFs/2025년 06월 12일/report.pdf
"~/Downloads 안의 PDF 전부 ~/Documents/PDFs 로 정리해줘"
→ organize_directory 호출 → 일괄 이동
"PDFs 폴더에 날짜별로 뭐가 있는지 보여줘"
→ list_date_folders 호출 → 폴더 목록 + 개수
"오늘 폴더에 있는 PDF 목록 보여줘"
→ list_pdfs_in_folder(date: "오늘")
"최근에 어떤 파일 정리했어?"
→ get_history 호출파라미터 상세
organize_pdf
파라미터 | 필수 | 설명 |
| ✅ | 정리할 PDF 경로 |
| ✅ | 날짜 폴더를 만들 루트 디렉토리 |
| ❌ | true이면 복사 (기본: 이동) |
| ❌ | 날짜 직접 지정 |
organize_directory
파라미터 | 필수 | 설명 |
| ✅ | PDF들이 있는 소스 디렉토리 |
| ✅ | 날짜 폴더를 만들 루트 디렉토리 |
| ❌ | true이면 복사 (기본: 이동) |
| ❌ | 날짜 직접 지정 |
| ❌ | 하위 폴더 탐색 여부 (기본: false) |
폴더 구조 예시
~/Documents/PDFs/
├── 2025년 06월 10일/
│ ├── invoice.pdf
│ └── contract.pdf
├── 2025년 06월 11일/
│ └── report.pdf
└── 2025년 06월 12일/
├── manual.pdf
└── manual(1).pdf ← 중복 파일명 자동 처리특징
📁 자동 폴더 생성: 날짜 폴더가 없으면 자동으로 생성
🔄 중복 파일명 처리:
file.pdf→file(1).pdf→file(2).pdf📝 이력 저장:
.air/data에 정리 이력 영구 보존📅 날짜 오버라이드: 과거/미래 날짜 폴더 지정 가능
🔁 복사 모드: 원본 유지하면서 정리 가능
Available Tools
6 toolsget_historyB
최근 PDF 정리 이력을 조회합니다.
Inputs: limit.
list_date_foldersB
정리된 날짜 폴더 목록과 각 폴더 내 PDF 파일 수를 조회합니다.
Inputs: base_dir (required).
list_pdfs_in_folderC
특정 날짜 폴더 안의 PDF 파일 목록을 조회합니다.
Inputs: base_dir (required), date (required).
organize_by_file_dateA
디렉토리 안의 PDF 파일을 각 파일의 날짜(수정일 또는 생성일) 기준으로 날짜별 폴더에 자동 분류합니다. 예: 6월 11일에 받은 파일 → "2026년 06월 11일" 폴더
Inputs: source_dir (required), base_dir (required), date_type, copy, +1 more.
organize_directoryC
특정 디렉토리 안에 있는 모든 PDF 파일을 오늘 날짜 폴더로 일괄 정리합니다.
Inputs: source_dir (required), base_dir (required), copy, date_override, +1 more.
organize_pdfC
PDF 파일을 오늘 날짜(YYYY년 MM월 DD일) 폴더로 자동 정리합니다. source_path에 PDF 경로, base_dir에 정리할 루트 폴더를 지정하세요.
Inputs: source_path (required), base_dir (required), copy, date_override.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools are mostly distinct: organizing by file date vs. today's date, single file vs. directory. However, organize_directory and organize_pdf both move to today's folder, potentially causing confusion.
Tools use consistent prefixes: list_ for listing, organize_ for actions, get_history for history. Minor inconsistency between get and list is acceptable.
6 tools is appropriate for a PDF organizer, covering key operations without being excessive.
Core organization and viewing workflows are covered, but missing undo/revert or manual file manipulation features.
Maintenance
Related MCP Connectors
Work on PDF files: compress, merge, split, convert, read scans, redact and check signatures.
Merge, split, extract, rotate, reorder and stamp PDF pages, and pull the text out of a PDF.
Extract PDFs into structured tables, query records, and configure document inbox workflows.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAutomatically organizes files in your Downloads folder by categorizing them into appropriate directories based on file types.6-
- AlicenseAqualityDmaintenanceA comprehensive tool server for reading, merging, and extracting content from PDF files via local paths or direct URLs. It enables metadata retrieval, regex searching, and page-specific text extraction with built-in caching and workspace-restricted security.97,136 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables PDF file manipulation including merging, splitting, extracting pages, extracting text, excluding pages, and reordering pages.1MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to analyze, rename, categorize, and organize local documents using OCR, metadata extraction, and batch processing, with preview mode and undo support.131MIT