Skip to content

Commit 4ff1b7e

Browse files
committed
remove the bundled mcp server and replace it with manual configuration instruction
1 parent 95c43c3 commit 4ff1b7e

File tree

4 files changed

+29
-26
lines changed

4 files changed

+29
-26
lines changed

plugins/calendar/.mcp.json

Lines changed: 0 additions & 8 deletions
This file was deleted.

plugins/calendar/README.md

Lines changed: 21 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Google Calendar integration for Claude Code, providing AI-powered tools to find
1515

1616
- Claude Code installed
1717
- Google Calendar API access configured
18-
- Google Calendar MCP server(bundled)
18+
- Google Calendar MCP server running locally
1919

2020
## Setup
2121

@@ -35,14 +35,24 @@ Google Calendar integration for Claude Code, providing AI-powered tools to find
3535
- Select **"Desktop app"** as the application type (Important!)
3636
- Download the auth key
3737

38-
### 2. Environment Configuration
38+
### 2. MCP Server Setup
3939

40-
After completing previous step, you must specify the credentials file path using the `GOOGLE_OAUTH_CREDENTIALS` environment variable prior to starting Claude Code, this tells the `google-calendar-mcp` MCP server where to look for auth keys.
40+
After completing the previous step, you need to set up the google-calendar MCP server locally.
4141

42-
```bash
43-
export GOOGLE_OAUTH_CREDENTIALS=~/.config/client_secret_xxxxxxxxx.json
44-
claude
45-
```
42+
1. **Install the google-calendar MCP server** (if not already installed):
43+
```bash
44+
npm install -g @cocal/google-calendar-mcp
45+
```
46+
47+
2. **Set environment variable** for credentials:
48+
```bash
49+
export GOOGLE_OAUTH_CREDENTIALS=~/.config/client_secret_xxxxxxxxx.json
50+
```
51+
52+
3. **Add the MCP server to Claude Code** with the MCP server running:
53+
```bash
54+
claude mcp add --transport stdio google-calendar -- npx @cocal/google-calendar-mcp
55+
```
4656

4757
## Installation
4858

@@ -170,8 +180,10 @@ See [commands/create-event.md](commands/create-event.md) for full documentation.
170180
- Verify OAuth scopes include calendar access
171181

172182
### MCP Server Issues
173-
- Ensure `@cocal/google-calendar-mcp` is available via npm
174-
- Check that the MCP server is properly configured
183+
- Ensure `@cocal/google-calendar-mcp` is installed and available
184+
- Check that the MCP server is properly configured in your Claude Code settings
185+
- Verify the MCP server is running and accessible
186+
- Check that the google-calendar MCP functions are available (e.g., `mcp__google-calendar__*`)
175187
- Verify network connectivity for API calls
176188

177189
For command-specific troubleshooting, see the individual command documentation.
@@ -182,4 +194,3 @@ For command-specific troubleshooting, see the individual command documentation.
182194
- **Calendar Data**: Free/busy information is queried in real-time and not stored
183195
- **Privacy**: Only calendar availability is accessed, not detailed event content
184196
- **Scope**: The plugin only requests minimal necessary Calendar API permissions
185-

plugins/calendar/commands/create-event.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,20 +38,20 @@ The `calendar:create-event` command creates a new calendar event on Google Calen
3838

3939
### Phase 3: Format Event Data
4040
- Convert all dates and times to ISO 8601 format
41-
- Use `get-current-time` tool to determine user's timezone
41+
- Use `mcp__google-calendar__get-current-time` function to determine user's timezone
4242
- Ensure start time is before end time
4343
- Format attendee list properly for calendar API
4444
- Prepare event description with any additional context
4545

4646
### Phase 4: Ask For User Confirmation
4747
- Display the summary, meeting time, attendees, description
4848
- Ask user to confirm
49-
- If user confirms, proceed to phase 5, otherwise, modify the summary, meeting time, attendees, description based on user's input until user confirms you correctly intepreted the intent.
49+
- If user confirms, proceed to phase 5, otherwise, modify the summary, meeting time, attendees, description based on user's input until user confirms you correctly interpreted the intent.
5050

5151
### Phase 5: Create Calendar Event
52-
- Use the `create-event` tool from the `plugin:calendar:google-calendar` MCP server
53-
- Automatically attach Google Meet link for virtual participation
54-
- Create event on user's primary calendar
52+
- Use the `mcp__google-calendar__create-event` function from the google-calendar MCP server
53+
- Automatically attach Google Meet link for virtual participation using the `conferenceData` parameter
54+
- Create event on user's primary calendar (calendarId: 'primary')
5555
- Include all parsed attendees, description, and meeting details
5656
- Handle calendar API responses and potential conflicts
5757

plugins/calendar/commands/find-time.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ The `calendar:find-time` command helps you find overlapping available time with
2424
- Convert duration to minutes if provided in other formats
2525

2626
### Phase 2: Gather Free/Busy Information
27-
- Use the `get-freebusy` tool from the `plugin:calendar:google-calendar` MCP server to get busy times for all participants
27+
- Use the `mcp__google-calendar__get-freebusy` function from the google-calendar MCP server to get busy times for all participants
2828
- Query the specified days_ahead for each participant's calendar
29-
- Get current time and primary calendar timezone using `get-current-time`
29+
- Get current time and primary calendar timezone using `mcp__google-calendar__get-current-time`
3030

3131
### Phase 3: Analyze Available Time Slots
3232
- Calculate free blocks by inverting busy periods for each participant
@@ -46,7 +46,7 @@ The `calendar:find-time` command helps you find overlapping available time with
4646
### Phase 5: Error Handling
4747
- Handle cases where no common free time exists
4848
- Provide helpful suggestions (shorter duration, different date range)
49-
- If you can't access a calendar, give up the operation gracefully. Then tell the user that the email adress maybe wrong
49+
- If you can't access a calendar, give up the operation gracefully. Then tell the user that the email address might be wrong
5050
- Validate that all email addresses have accessible calendars
5151

5252
## Return Value

0 commit comments

Comments
 (0)