{"id":23973292,"url":"https://github.com/wtbates99/pandas-monday","last_synced_at":"2026-04-20T13:31:52.050Z","repository":{"id":268570642,"uuid":"904770126","full_name":"wtbates99/pandas-monday","owner":"wtbates99","description":"Python library that provides seamless integration between pandas DataFrames and Monday.com boards. Easily read Monday.com board data into pandas DataFrames with support for subitems, pagination, and column filtering. Built with the Monday.com GraphQL API.","archived":false,"fork":false,"pushed_at":"2025-01-20T16:44:32.000Z","size":51,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-20T17:43:26.027Z","etag":null,"topics":["api-wrapper","data-analysis","data-integration","dataframe","graphql","monday","pandas","productivity-tools","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wtbates99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-17T14:16:18.000Z","updated_at":"2025-01-20T16:44:33.000Z","dependencies_parsed_at":"2024-12-17T16:19:33.437Z","dependency_job_id":"f68ca46b-f4d6-418e-9cd9-b16453368ac7","html_url":"https://github.com/wtbates99/pandas-monday","commit_stats":null,"previous_names":["wtbates99/pandas-monday"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtbates99%2Fpandas-monday","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtbates99%2Fpandas-monday/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtbates99%2Fpandas-monday/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtbates99%2Fpandas-monday/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wtbates99","download_url":"https://codeload.github.com/wtbates99/pandas-monday/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240507431,"owners_count":19812794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-wrapper","data-analysis","data-integration","dataframe","graphql","monday","pandas","productivity-tools","python"],"created_at":"2025-01-07T04:55:36.970Z","updated_at":"2025-10-09T00:21:52.840Z","avatar_url":"https://github.com/wtbates99.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pandas-monday\n\nThe goal is to create a Python package that enables seamless integration between pandas DataFrames and Monday.com boards. This library allows you to easily read data from Monday.com boards into pandas DataFrames and write DataFrames back to Monday.com boards.\n\n## Installation\n\n**You cannot currently install this package from PyPI using pip install.**\nInstead, clone the repository and install the requirements:\n\n```bash\ngit clone https://github.com/wtbates99/pandas-monday.git\ncd pandas-monday\npip install -r requirements.txt\n```\n\n## Quick Start\n\n```python\nimport pandas_monday as pm\n\n# Initialize client using environment variable MONDAY_API_TOKEN\nclient = pm.monday_pandas()\n\n# Or explicitly pass your API token\nclient = pm.monday_pandas(api_token=\"your-api-token\")\n\n# Read from a board\ndf = client.read_board(board_id=\"your-board-id\")\n```\n\n## Features\n\n- Read Monday.com boards into pandas DataFrames\n- Write pandas DataFrames to Monday.com boards\n- Support for subitems\n- Multiple write modes and overwrite options\n- Automatic type conversion between pandas and Monday.com\n- Error handling and validation\n\n## Authentication\n\nTo use this package, you'll need a Monday.com API token. You can either:\n\n1. Set it as an environment variable named `MONDAY_API_TOKEN`\n2. Pass it directly when initializing the client\n\nTo get an API token:\n1. Go to your Monday.com account\n2. Click on your avatar in the bottom left\n3. Go to Developer \u003e API\n4. Generate a new token\n\n## Usage Examples\n\n### Reading from Monday.com\n\n```python\nimport pandas_monday as pm\n\nclient = pm.monday_pandas()\n\n# Basic read\ndf = client.read_board(board_id=\"your-board-id\")\n\n# Read with subitems\ndf = client.read_board(\n    board_id=\"your-board-id\",\n    include_subitems=True\n)\n\n# Read specific columns\ndf = client.read_board(\n    board_id=\"your-board-id\",\n    columns=['name', 'status', 'numbers']\n)\n```\n\n### Writing to Monday.com\n\n```python\nimport pandas as pd\nimport pandas_monday as pm\n\nclient = pm.monday_pandas()\n\n# Read your data\ndf = pd.read_csv(\"data.csv\")\n\n# Write to board\nclient.write_board(\n    board_id=\"your-board-id\",\n    df=df,\n    mode=\"replace\",      # Options: \"append\", \"replace\"\n    overwrite_type=\"archive\"  # Options: \"archive\", \"delete\"\n)\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtbates99%2Fpandas-monday","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwtbates99%2Fpandas-monday","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtbates99%2Fpandas-monday/lists"}