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.
Related MCP Servers
- Flicense-qualityDmaintenanceAutomatically organizes files in your Downloads folder by categorizing them into appropriate directories based on file types.Last updated6
- 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.Last updated9MIT
- Alicense-qualityDmaintenanceEnables PDF file manipulation including merging, splitting, extracting pages, extracting text, excluding pages, and reordering pages.Last updated661MIT
- Alicense-qualityDmaintenanceEnables AI assistants to analyze, rename, categorize, and organize local documents using OCR, metadata extraction, and batch processing, with preview mode and undo support.Last updatedMIT
Related MCP Connectors
Tag, rename, and enrich PDFs and images. Free tier: 1,500 tags/month, no credit card.
Fill existing fillable, flat and scanned PDF forms from structured data; save reusable templates
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- 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