Skip to content

Export Monday.com tasks to markdown for AI assistants (ChatGPT, Claude, Gemini). Bridge your Monday.com workflow with AI tools.

License

Notifications You must be signed in to change notification settings

crarau/monday-to-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Monday.com to AI Export Tool πŸš€

Transform your Monday.com tasks into AI-ready markdown with full context, images, and discussions

License: MIT Python 3.6+ Monday.com API

🎯 Why This Tool?

Working with AI assistants like ChatGPT, Claude, or Gemini on your Monday.com projects? This tool bridges the gap by exporting your Monday.com tasks with complete context - including all comments, replies, images, and attachments - into clean markdown that AI assistants can understand perfectly.

✨ Key Features

  • πŸ“‹ Complete Context Export - Every comment, reply, and discussion thread
  • πŸ–ΌοΈ Image Preservation - Downloads and embeds all referenced images
  • πŸ“Ž File Attachments - Captures all attached documents
  • πŸ€– AI-Optimized Format - Clean markdown structure that AI models parse perfectly
  • πŸ’¬ Thread Preservation - Maintains conversation hierarchy and context
  • 🎨 Clean Output - Beautiful, readable markdown files

πŸ–ΌοΈ What You Get

Before: Monday.com Interface

πŸ“‹ Task in Monday.com:
- Information scattered across columns
- Comments in separate thread view
- Images as attachments
- Replies nested in UI
- Hard to copy/share full context

After: Clean Markdown Export

πŸ“„ Single markdown file with:
βœ… All task information in one place
βœ… Complete comment history with timestamps
βœ… Images downloaded and embedded
βœ… Reply threads preserved
βœ… Ready to paste into any AI chat

πŸ“„ Example Output


Web: Implement Dark Mode Feature

Exported from Monday.com on 2024-03-15 14:30

πŸ“Œ Task Information

  • Board: Product Development Sprint
  • Workspace: Engineering Team
  • Group: IN PROGRESS
  • Status: Development πŸš€
  • Assigned to: Alex Rodriguez, Emma Watson
  • Due Date: 2024-03-20
  • Priority: High
  • Story Points: 8

πŸ’¬ Comments & Discussion

πŸ’­ Sarah Chen - 2024-03-12 10:30

@Alex @Emma Let's implement dark mode! Here's the design mockup from our designer:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   πŸŒ™ DARK MODE DESIGN MOCKUP        β”‚
β”‚                                     β”‚
β”‚   [Toggle] ● Dark β—‹ Light β—‹ Auto   β”‚
β”‚                                     β”‚
β”‚   Background: #1a1a1a              β”‚
β”‚   Text: #ffffff                    β”‚
β”‚   Accent: #6366f1                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

[Image: dark_mode_design.png - 600x400px]

Key requirements:

  • Toggle in settings menu
  • Respect system preferences
  • Smooth CSS transitions

πŸ’¬ Replies:

↳ Alex Rodriguez - 2024-03-12 11:15

Great! I'll start with the theme context provider...

↳ Emma Watson - 2024-03-12 14:20

I'll handle the UI components...

πŸ’­ Alex Rodriguez - 2024-03-13 16:45

Progress update: Core implementation done! βœ…

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  🎨 DARK MODE TOGGLE - WORKING!          β”‚
β”‚                                          β”‚
β”‚  Settings > Appearance                  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”             β”‚
β”‚  β”‚ Theme:  [πŸŒ™ Dark Mode] β”‚             β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜             β”‚
β”‚                                          β”‚
β”‚  βœ… Toggle animation working             β”‚
β”‚  βœ… Preference saved to localStorage     β”‚
β”‚  βœ… All components updated               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

[Image: dark_mode_working.gif - 600x350px]

Created React context with theme switching...


See full example output β†’

πŸš€ Quick Start

1. Install

git clone https://github.com/crarau/monday-to-ai.git
cd monday-to-ai
pip install -r requirements.txt

2. Get Your Monday.com API Token

  1. Log into Monday.com
  2. Click your avatar β†’ Developers
  3. Click Developer β†’ My Access Tokens
  4. Create a personal API token
  5. Copy and save it to .env:
echo 'MONDAY_API_TOKEN=your-token-here' > .env

3. Export Your First Task

# Using a Monday.com URL
python monday_exporter.py https://yourworkspace.monday.com/boards/123/pulses/456

# Or just the item ID
python monday_exporter.py 456

πŸ“‚ Output Structure

Each export creates a clean folder structure:

Task_Name/
β”œβ”€β”€ README.md           # Complete task in markdown
└── images/            # All images from comments
    β”œβ”€β”€ comment_0_0.png
    β”œβ”€β”€ reply_1_0.png
    └── attachment_2.pdf

🀝 Perfect for AI Workflows

Use Case 1: Code Review with AI

Export your code review task from Monday.com and share with ChatGPT or Claude for detailed analysis.

Use Case 2: Bug Investigation

Export bug reports with all screenshots and discussions for AI-assisted debugging.

Use Case 3: Feature Planning

Share feature requests with AI to generate implementation plans and technical specs.

Use Case 4: Documentation

Convert Monday.com tasks into technical documentation with AI assistance.

πŸ“Š What Gets Exported?

Content Type Exported Details
Task metadata βœ… Title, status, dates, assignees
Custom fields βœ… All column values
Comments βœ… Full comment history
Replies βœ… Threaded conversations
Images βœ… Downloaded locally
File attachments βœ… Referenced with links
@mentions βœ… Preserved in text
Emojis βœ… Rendered correctly
Code blocks βœ… With syntax highlighting
Updates βœ… Status changes, edits

πŸ’‘ Pro Tips

Batch Export

# Export multiple tasks
for id in 123 456 789; do
    python monday_exporter.py $id
done

Generate PDFs

# Add --pdf flag for PDF output
python monday_exporter.py 456 --pdf

CI/CD Integration

# GitHub Action example
- name: Export Monday Task
  run: |
    python monday_exporter.py ${{ github.event.inputs.monday_id }}

πŸ”§ Configuration

Environment Variables

  • MONDAY_API_TOKEN - Your Monday.com API token (required)

Optional Settings

  • Customize output directory
  • Filter specific fields
  • Choose export format

πŸ›‘οΈ Security

  • βœ… API tokens stored in .env (never committed)
  • βœ… Read-only access to Monday.com
  • βœ… Local storage of exports
  • βœ… No data sent to third parties

πŸ“ˆ Monday.com API Limits

  • Rate Limit: 5,000 requests/minute
  • Complexity: 10M points/minute
  • This tool uses ~100 points per task

πŸ€” FAQ

Q: Does this work with Monday.com Enterprise? A: Yes! Works with all Monday.com plans that have API access.

Q: Can I export entire boards? A: Currently exports individual items. Board export coming soon!

Q: Are subitems included? A: Yes, subitems are exported as part of the main task.

Q: What about private boards? A: You can export any board/item your API token has access to.

🚦 Roadmap

  • Bulk export multiple items
  • Export entire boards
  • Custom field mapping
  • Notion export format
  • Obsidian export format
  • Interactive CLI with progress bars
  • Web interface
  • Monday.com app integration

🀝 Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

πŸ“„ License

MIT License - see LICENSE

πŸ™ Acknowledgments

  • Built for the Monday.com community
  • Inspired by the need to leverage AI for project management
  • Special thanks to all contributors

πŸ”— Links


Made with ❀️ for better Monday.com β†’ AI workflows
Monday.com β€’ GitHub β€’ API Docs

About

Export Monday.com tasks to markdown for AI assistants (ChatGPT, Claude, Gemini). Bridge your Monday.com workflow with AI tools.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages