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 "Install 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-mcpOrganize ~/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에 정리 이력 영구 보존📅 날짜 오버라이드: 과거/미래 날짜 폴더 지정 가능
🔁 복사 모드: 원본 유지하면서 정리 가능
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jihoho12/pdf_organizer'
If you have feedback or need assistance with the MCP directory API, please join our Discord server