# notion-to-llms-txt
🤖 Convert your Notion workspace exports into AI-friendly LLMS.txt format
## The Problem
When working with AI agents like Claude, ChatGPT, or coding assistants, you often need to explain "where things are" in your Notion workspace. Without context about your documentation structure, AI agents:
- ❌ Can't efficiently navigate your knowledge base
- ❌ Don't know which pages contain relevant information
- ❌ Waste time with ineffective searches
- ❌ Miss important documentation that could solve problems faster
## The Solution
**notion-to-llms-txt** creates a structured map of your entire Notion workspace that AI agents can instantly understand. Think of it as a "table of contents" optimized for AI consumption.
## What You Get
✅ **Instant workspace overview** - AI agents know exactly what documentation exists
✅ **Proper page prioritization** - Important pages (larger content) appear first
✅ **Direct Notion links** - AI can guide you to specific pages when needed
✅ **Hierarchical structure** - Preserves your workspace organization
## Installation
### Option 1: UV (Recommended)
```bash
# Install UV if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install notion-to-llms-txt
uv tool install notion-to-llms-txt
```
### Option 2: pip
```bash
pip install notion-to-llms-txt
```
## Usage
### Step 1: Export from Notion
**For workspace admins:**
1. **Settings & members** → **Settings** → **Export content**
**For individual pages:**
1. Click **⋯** (three dots) on any page → **Export**
**Export settings:**
- Format: **Markdown & CSV**
- Content: **No files or images**
- ✅ **Include subpages**
Extract the downloaded ZIP file to a folder.
📖 [Official Notion export guide](https://www.notion.so/help/export-your-content)
### Step 2: Generate LLMS.txt
```bash
notion-to-llms-txt /path/to/extracted/notion-export
```
**Advanced filtering options:**
```bash
# Exclude small pages and customize output
notion-to-llms-txt /path/to/export --min-chars 200 --snippet-length 50
# See all options
notion-to-llms-txt --help
```
### Step 3: What You Get
The tool generates a `notion-llms.txt` file like this:
```markdown
# Notion Workspace
> Notion page structure and links overview
## Projects
- [AI Development Guidelines](https://notion.so/abc123...): Complete guide for AI project workflows
- [Product Roadmap 2025](https://notion.so/def456...): Strategic planning and feature priorities
- [Engineering Standards](https://notion.so/ghi789...): Code review and deployment processes
## Team Documentation
- [Onboarding Checklist](https://notion.so/jkl012...): New team member setup guide
- [Meeting Notes Archive](https://notion.so/mno345...): Historical meeting records and decisions
```
## Recommended Usage
### 🎯 Share with AI Agents
1. **Upload to your favorite AI agent** (Claude, ChatGPT, etc.)
2. **Include in your prompts**: "Here's my workspace structure: [attach notion-llms.txt]"
3. **Place in Notion**: Create a "AI Agent Resources" page and paste the content
### 🚀 Best Practice: Combine with Notion MCP
LLMS.txt provides a **snapshot** of your workspace structure but isn't real-time. For optimal AI assistance:
1. **Use LLMS.txt for overview**: "This workspace map was created on [date]. Use it to understand my documentation structure."
2. **Use [Notion MCP](https://developers.notion.com/docs/mcp) for details**: "For the latest content and detailed information, access pages directly via Notion MCP."
This combination gives AI agents both **structural context** and **live data access**.
### 💡 Example Conversations
**Before notion-to-llms-txt:**
> "Can you help me find our deployment process documentation?"
>
> *AI: "I don't have access to your Notion workspace. Could you search for deployment-related pages?"*
**After notion-to-llms-txt:**
> "Can you help me find our deployment process documentation?" [includes LLMS.txt]
>
> *AI: "Based on your workspace structure, check the 'Engineering Standards' page at https://notion.so/ghi789... - it likely contains your deployment processes."*
### 🔄 Keep It Updated
Re-run the tool whenever you:
- Add major new pages or sections
- Reorganize your workspace structure
- Want to refresh AI agent knowledge
## What is LLMS.txt?
[LLMS.txt](https://llmstxt.org/) is a proposed standard for providing structured information to Large Language Models. It's like a `robots.txt` for AI - a simple way to help AI agents understand your content structure.
## Requirements
- Python 3.11+
- UV package manager
- Notion workspace with export access
## Development
See [CLAUDE.md](CLAUDE.md) for development context and contributing guidelines.
## License
Apache 2.0 - see [LICENSE](LICENSE) for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "notion-to-llms-txt",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, documentation, export, llms, markdown, notion",
"author": null,
"author_email": "Tomoaki Nakamura <tomoaki.nakamura@elyza.ai>",
"download_url": "https://files.pythonhosted.org/packages/60/28/51674ba6955983f113d2fdc321fc9723d6647646eb75c7bccc2526c0b8d4/notion_to_llms_txt-0.1.1.tar.gz",
"platform": null,
"description": "# notion-to-llms-txt\n\n\ud83e\udd16 Convert your Notion workspace exports into AI-friendly LLMS.txt format\n\n## The Problem\n\nWhen working with AI agents like Claude, ChatGPT, or coding assistants, you often need to explain \"where things are\" in your Notion workspace. Without context about your documentation structure, AI agents:\n\n- \u274c Can't efficiently navigate your knowledge base\n- \u274c Don't know which pages contain relevant information \n- \u274c Waste time with ineffective searches\n- \u274c Miss important documentation that could solve problems faster\n\n## The Solution\n\n**notion-to-llms-txt** creates a structured map of your entire Notion workspace that AI agents can instantly understand. Think of it as a \"table of contents\" optimized for AI consumption.\n\n## What You Get\n\n\u2705 **Instant workspace overview** - AI agents know exactly what documentation exists \n\u2705 **Proper page prioritization** - Important pages (larger content) appear first \n\u2705 **Direct Notion links** - AI can guide you to specific pages when needed \n\u2705 **Hierarchical structure** - Preserves your workspace organization \n\n## Installation\n\n### Option 1: UV (Recommended)\n\n```bash\n# Install UV if you haven't already\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Install notion-to-llms-txt\nuv tool install notion-to-llms-txt\n```\n\n### Option 2: pip\n\n```bash\npip install notion-to-llms-txt\n```\n\n## Usage\n\n### Step 1: Export from Notion\n\n**For workspace admins:**\n1. **Settings & members** \u2192 **Settings** \u2192 **Export content**\n\n**For individual pages:**\n1. Click **\u22ef** (three dots) on any page \u2192 **Export**\n\n**Export settings:**\n- Format: **Markdown & CSV**\n- Content: **No files or images** \n- \u2705 **Include subpages**\n\nExtract the downloaded ZIP file to a folder.\n\n\ud83d\udcd6 [Official Notion export guide](https://www.notion.so/help/export-your-content)\n\n### Step 2: Generate LLMS.txt\n\n```bash\nnotion-to-llms-txt /path/to/extracted/notion-export\n```\n\n**Advanced filtering options:**\n```bash\n# Exclude small pages and customize output\nnotion-to-llms-txt /path/to/export --min-chars 200 --snippet-length 50\n\n# See all options\nnotion-to-llms-txt --help\n```\n\n### Step 3: What You Get\n\nThe tool generates a `notion-llms.txt` file like this:\n\n```markdown\n# Notion Workspace\n\n> Notion page structure and links overview\n\n## Projects\n- [AI Development Guidelines](https://notion.so/abc123...): Complete guide for AI project workflows\n- [Product Roadmap 2025](https://notion.so/def456...): Strategic planning and feature priorities \n- [Engineering Standards](https://notion.so/ghi789...): Code review and deployment processes\n\n## Team Documentation \n- [Onboarding Checklist](https://notion.so/jkl012...): New team member setup guide\n- [Meeting Notes Archive](https://notion.so/mno345...): Historical meeting records and decisions\n```\n\n## Recommended Usage\n\n### \ud83c\udfaf Share with AI Agents\n\n1. **Upload to your favorite AI agent** (Claude, ChatGPT, etc.)\n2. **Include in your prompts**: \"Here's my workspace structure: [attach notion-llms.txt]\"\n3. **Place in Notion**: Create a \"AI Agent Resources\" page and paste the content\n\n### \ud83d\ude80 Best Practice: Combine with Notion MCP\n\nLLMS.txt provides a **snapshot** of your workspace structure but isn't real-time. For optimal AI assistance:\n\n1. **Use LLMS.txt for overview**: \"This workspace map was created on [date]. Use it to understand my documentation structure.\"\n2. **Use [Notion MCP](https://developers.notion.com/docs/mcp) for details**: \"For the latest content and detailed information, access pages directly via Notion MCP.\"\n\nThis combination gives AI agents both **structural context** and **live data access**.\n\n### \ud83d\udca1 Example Conversations\n\n**Before notion-to-llms-txt:**\n> \"Can you help me find our deployment process documentation?\"\n> \n> *AI: \"I don't have access to your Notion workspace. Could you search for deployment-related pages?\"*\n\n**After notion-to-llms-txt:**\n> \"Can you help me find our deployment process documentation?\" [includes LLMS.txt]\n> \n> *AI: \"Based on your workspace structure, check the 'Engineering Standards' page at https://notion.so/ghi789... - it likely contains your deployment processes.\"*\n\n### \ud83d\udd04 Keep It Updated\n\nRe-run the tool whenever you:\n- Add major new pages or sections\n- Reorganize your workspace structure \n- Want to refresh AI agent knowledge\n\n## What is LLMS.txt?\n\n[LLMS.txt](https://llmstxt.org/) is a proposed standard for providing structured information to Large Language Models. It's like a `robots.txt` for AI - a simple way to help AI agents understand your content structure.\n\n## Requirements\n\n- Python 3.11+\n- UV package manager \n- Notion workspace with export access\n\n## Development\n\nSee [CLAUDE.md](CLAUDE.md) for development context and contributing guidelines.\n\n## License\n\nApache 2.0 - see [LICENSE](LICENSE) for details.",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Convert Notion exports to LLMS.txt format for AI agents",
"version": "0.1.1",
"project_urls": null,
"split_keywords": [
"ai",
" documentation",
" export",
" llms",
" markdown",
" notion"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b121ba2b07ee6a0f44569f2c5552e2d3319965c0aa6fce7f5ddb426d73520747",
"md5": "3863dc4c41107a19db04c39f33cfc2d8",
"sha256": "19357854f9d45be3d49506f61b016ad92b87362f92c18c70442fcffc503484de"
},
"downloads": -1,
"filename": "notion_to_llms_txt-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3863dc4c41107a19db04c39f33cfc2d8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 13982,
"upload_time": "2025-08-03T17:47:30",
"upload_time_iso_8601": "2025-08-03T17:47:30.274334Z",
"url": "https://files.pythonhosted.org/packages/b1/21/ba2b07ee6a0f44569f2c5552e2d3319965c0aa6fce7f5ddb426d73520747/notion_to_llms_txt-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "602851674ba6955983f113d2fdc321fc9723d6647646eb75c7bccc2526c0b8d4",
"md5": "bb7874499fcd765fa9459b6b3c7d092d",
"sha256": "d12cd7331108559b8ad7fe5715a1222a956d845c80404f6698a401bf9cd97840"
},
"downloads": -1,
"filename": "notion_to_llms_txt-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "bb7874499fcd765fa9459b6b3c7d092d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 35267,
"upload_time": "2025-08-03T17:47:31",
"upload_time_iso_8601": "2025-08-03T17:47:31.792354Z",
"url": "https://files.pythonhosted.org/packages/60/28/51674ba6955983f113d2fdc321fc9723d6647646eb75c7bccc2526c0b8d4/notion_to_llms_txt-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-03 17:47:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "notion-to-llms-txt"
}
JSON