Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/timrutte/sparkasse-notion-sync
This tool synchronizes german Sparkasse account balances with a Notion database using an AWS Lambda function written in Go. It leverages Sparkasse's "Kontowecker" feature, which sends transaction updates via email. The entire setup is provisionable via Terraform.
https://github.com/timrutte/sparkasse-notion-sync
aws go golang lambda notion notion-api notion-database sync terraform
Last synced: about 7 hours ago
JSON representation
This tool synchronizes german Sparkasse account balances with a Notion database using an AWS Lambda function written in Go. It leverages Sparkasse's "Kontowecker" feature, which sends transaction updates via email. The entire setup is provisionable via Terraform.
- Host: GitHub
- URL: https://github.com/timrutte/sparkasse-notion-sync
- Owner: TimRutte
- License: mit
- Created: 2024-10-21T08:57:10.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-02T11:58:43.000Z (2 months ago)
- Last Synced: 2024-11-11T23:35:26.254Z (2 months ago)
- Topics: aws, go, golang, lambda, notion, notion-api, notion-database, sync, terraform
- Language: HCL
- Homepage:
- Size: 29.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS.md
Awesome Lists containing this project
README
# Sparkasse to Notion Sync
This tool synchronizes Sparkasse account balances with a Notion database using an AWS Lambda function written in Go. It leverages Sparkasse's "Kontowecker" feature, which sends transaction updates via email. The entire setup is provisionable via Terraform.
## Features
- **AWS Lambda Function**: Written in Go, this function processes transaction updates.
- **Sparkasse Kontowecker Integration**: Utilizes the email alerts from Sparkasse's Kontowecker feature.
- **Notion Database Sync**: Updates your Notion database with the latest account balances and transactions.
- **Infrastructure as Code**: Provision all resources using Terraform.
## Requirements
- **AWS Account**: To deploy the Lambda function and related resources.
- **Sparkasse Account**: With the Kontowecker feature enabled for email notifications.
- **Notion Account**: With a database setup to receive account balance updates.
- **Terraform**: Installed on your local machine.
## Setup
### 1. Configure Sparkasse Kontowecker
1. Log in to your Sparkasse account.
2. Navigate to the Kontowecker section.
3. Set up email notifications for transaction updates to a dedicated email address.
### 2. Prepare the Notion Database
1. Create a new database in Notion to store your account balances and transactions.
2. Note down the integration token and database ID for Notion API access.
### 3. Deploy with Terraform
1. Clone this repository:
2. Initialize Terraform:
3. Update the `terraform.tfvars` file with your specific configurations:
4. Deploy the infrastructure:
### 4. Set Up Email Forwarding
1. Set up an email forwarding rule to forward Sparkasse Kontowecker emails to the AWS Lambda function's email endpoint.
## Usage
Once the setup is complete, the AWS Lambda function will automatically process incoming emails from Sparkasse Kontowecker and update your Notion database with the latest account balances and transaction amounts.
## Development
### Prerequisites
- **Go**: Installed on your local machine.
- **Terraform**: Installed on your local machine.
### Build and Deploy Locally
tbd
## Contributing
Contributions are welcome! Please fork this repository and submit a pull request with your changes.
## License
This project is licensed under the MIT License. See the `LICENSE` file for details.
## Acknowledgements
- [Sparkasse](https://www.sparkasse.de/) for their banking services and Kontowecker feature.
- [Notion](https://www.notion.so/) for their powerful and flexible database platform.
- [AWS](https://aws.amazon.com/) for providing the cloud infrastructure.
- [Terraform](https://www.terraform.io/) for enabling infrastructure as code.