What can you do with this server?

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; supports YYYY-MM-DD or "오늘" (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.

How do I use pdf-organizer-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., "@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 build

Related 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가지

툴 이름	설명
`organize_pdf`	PDF 파일 1개를 오늘 날짜 폴더로 이동/복사
`organize_directory`	디렉토리 내 모든 PDF를 일괄 정리
`list_date_folders`	날짜 폴더 목록 + PDF 개수 조회
`list_pdfs_in_folder`	특정 날짜 폴더의 PDF 목록 조회
`get_history`	최근 정리 이력 조회

사용 예시 (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`

파라미터	필수	설명
`source_path`	✅	정리할 PDF 경로
`base_dir`	✅	날짜 폴더를 만들 루트 디렉토리
`copy`	❌	true이면 복사 (기본: 이동)
`date_override`	❌	날짜 직접 지정 `YYYY-MM-DD`

`organize_directory`

파라미터	필수	설명
`source_dir`	✅	PDF들이 있는 소스 디렉토리
`base_dir`	✅	날짜 폴더를 만들 루트 디렉토리
`copy`	❌	true이면 복사 (기본: 이동)
`date_override`	❌	날짜 직접 지정 `YYYY-MM-DD`
`recursive`	❌	하위 폴더 탐색 여부 (기본: 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 tools

get_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…

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

B3.3/5.0

Scored 2026-06-13 18:55 across 6 tools

Disambiguation4/5

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.

Naming Consistency4/5

Tools use consistent prefixes: list_ for listing, organize_ for actions, get_history for history. Minor inconsistency between get and list is acceptable.

Tool Count4/5

6 tools is appropriate for a PDF organizer, covering key operations without being excessive.

Completeness3/5

Core organization and viewing workflows are covered, but missing undo/revert or manual file manipulation features.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

pdf.net
net.pdf
Create, convert, organize PDFs
Workplace & Productivity File Systems
1
https://mcp.pdf.net/mcp
McpStamp PDF ToolsA
io.github.theluckystrike
Merge, split, extract, rotate, reorder and stamp PDF pages, and pull the text out of a PDF.
File Systems
151
https://mcp.zovo.one/mcp/pdf
PdfParseB
io.github.PabloG6
Extract PDFs into structured tables, query records, and configure document inbox workflows.
Data Platforms Databases File Systems
291
https://mcp.pdfparse.net/mcp
EmbossA
io.github.edwinorange
Make any PDF form fillable, fill it from data or documents, read it back, and fax the result.
App Automation Workplace & Productivity
281
https://api.getemboss.ai/mcp

Related MCP Servers

Cursor MCP File Organizer
File Systems App Automation Developer Tools
AlexanderVTr
F
license
Not graded
quality
D
maintenance
Automatically organizes files in your Downloads folder by categorizing them into appropriate directories based on file types.
Updated a year ago (2025-07-11 14:44 UTC)
6
-
PDF Tools MCP Server
File Systems Developer Tools Documentation Access
lockon-n
A
license
A
quality
D
maintenance
A 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.
Updated a year ago (2025-08-10 17:20 UTC)
9
5,840 PyPI
MIT
PDF Tools MCP Server
File Systems Developer Tools
h-ucchi
A
license
Not graded
quality
D
maintenance
Enables PDF file manipulation including merging, splitting, extracting pages, extracting text, excluding pages, and reordering pages.
Updated 10 months ago (2025-12-27 06:51 UTC)
27 npm
1
MIT
mcp-document-intelligence
File Systems
AndreasDietzel
A
license
B
quality
B
maintenance
Enables AI assistants to analyze, rename, categorize, and organize local documents using OCR, metadata extraction, and batch processing, with preview mode and undo support.
Updated 10 days ago (2026-10-31 23:22 UTC)
13
1
MIT