# MCP server for Google Calendar
## Credentials
The `credentials.json` file is needed to authenticate againts the Google services.
To generate the file, the following steps must be performed:
1. Visit the _Google Cloud Platform_ website
2. Crete a new project (or use an existant one)
3. Into the _APIs & Services_ section, enable the _Google Calendar API_ service
4. Go to _Credentials_ and generate a new credential as _Service Account_
5. Copy the service account's email generated. It will be needed to share the calendar with it
6. After the credential is created, a JSON file will be able to download. Place it into the root of this project and name it as `credentials.json`
## Calendar sharing
To interact with a calendar, it needs to be shared with the service account previously created to access it following these steps:
1. Visit the _Google Calendar_ website
2. Into the sidebar, place on the target calendar, click the three dots (...) and then go to _Settings and sharing_
3. Go the _Shared with_ and add the email address for the service account copied previously when the credential was created
4. Go to _Integrate calendar_ and copy the _Calendar ID_ value
## Inspector
While developing, you can use the inspector to debug the server. To do this:
```bash
npm run inspector
```
## Build MCP Server
Before adding the MCP server to the configuration file, you need to build it. The build process will create a Docker image that can be run in WSL.
```bash
npm run build
docker build -t mcpserver-googlecalendar .
```
## Add MCP Server
To add the MCP server, add to the configuration file and paste the _Calendar ID_ copied previously:
```json
{
"mcpServers": {
"google-calendar": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GOOGLE_CALENDAR_ID",
"mcpserver-googlecalendar"
],
"env": {
"GOOGLE_CALENDAR_ID": "[CALENDAR_ID_HERE]"
}
}
}
}
```
