Calendar MCP Server Tools

Adding your own MCP server walkthough

1. Get your environment set up

# clone this repo
git clone https://github.com/cohere-ai/north-mcp-python-sdk.git

# enter the repo
cd north-mcp-python-sdk

# switch to our wise branch
git switch wise_2026_conference

# go into our example directory
cd wise_examples

# install uv 
curl -LsSf https://astral.sh/uv/install.sh | sh

# install the requirements
uv sync

# activate the newly created environment
source .venv/bin/activate

To install ngrok follow the instructions here https://ngrok.com/download

If you have not previously run ngrok you will get the following error when running

ngrok http <port>

ValueError: ('failed to connect session', 'Usage of ngrok requires a verified account and authtoken.\
Sign up for an account: https://dashboard.ngrok.com/signup\n \
Install your authtoken: https://dashboard.ngrok.com/get-started/your-authtoken', 'ERR_NGROK_4018')

You must create an account and get your authtoken

https://dashboard.ngrok.com/signup
https://dashboard.ngrok.com/get-started/your-authtoken

To add your authtoken you can run

ngrok config add-authtoken $YOUR_AUTHTOKEN

---

2. Create your MCP servers

code simple_calculator.py
code <mcp_server_filename>

Start your server with

uv run <mcp_server_filename>

Start your ngrok server with

ngrok http <port>
ie. ngrok http 3001

---

3. (Optional) Hard-code your connector credentials

In some instances your MCP server will need to connect to another service such as the google api (for google calendar, gmail, drive, etc.) or spotify, linear, etc.

Here's how to get the credentials for a common connector: Google API

Step-by-step to get OAuth Client ID and Secret:

1. Go to https://console.cloud.google.com
2. Create/Select a Project:
3. Click the project dropdown at the top
4. Click "New Project" or select an existing one

Enable Calendar API:

5. Go to "APIs & Services" → "Library" (left sidebar). Note if it's not in the left sidebar then click on View all Products at the bottom left-hand side of the screen to view the Library.
6. Search for "Google Calendar API"
7. Click it and press "Enable"

Create OAuth Credentials:

8. Go to "APIs & Services" → "Credentials" (left sidebar)

9. Click "Create Credentials" → "OAuth client ID"

10. If prompted, configure the OAuth consent screen first:

11. Fill in app name (e.g., "My Calendar App")
12. Add your email
13. Choose "External"

Back to Create OAuth client ID:

14. Choose "Desktop app" as Application type
15. Give it a name (e.g., "Calendar Desktop Client")

16. Head to the Audience tab and click +Add users to add the Test users. Add your email here

Get Your Credentials:

17. A popup shows your Client ID and Client Secret; Copy both and/or download the JSON file. You can always view them again in the Credentials page

Next we need to use these to get our access token.

18. Add your downloaded JSON file with the Client ID and Client Secret to client_secret.json

19. Run get_google_access_token.py and it'll output your access token. This will expire in 1 hour! To generate a new token just run the script again!

We can now use the google access tokne in our google calendar mcp server. You can either add your access token to the top of your simple_calendar.py file as ACCESS_TOKEN="", or add it to your .env and load it in.

---

4. Add your MCP server to North

NOTE: Tool names MUST be unique when creating your MCP server, so please prepend the tool name with a prefix such as <first_name><last_name><tool_name>

To get your North Token go to https://gtxcc.democloud.cohere.com/developer/python

Run the following commands:

export NORTH_TOKEN=<north token>
export HOST=https://gtxcc.democloud.cohere.com/api
export URL=<ngrok url>

To see which servers are running:

curl --location "${HOST}/internal/v1/mcp_servers" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${NORTH_TOKEN}"

To register your server:

curl --location "${HOST}/internal/v1/mcp_servers" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${NORTH_TOKEN}" \
--data '{
    "url": "'"${URL}"'",
    "name": "Google Calendar"
}'

To delete your server:

curl --location --request DELETE "${HOST}/internal/v1/mcp_servers/<server_id>" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${NORTH_TOKEN}"

Your server is now running!

Sign into North here to try it out! You must create a new account with this domain wiseconference.com to have access to North!

https://gtxcc.democloud.cohere.com/

You'll now be able to see the new connector. Click to enable it!

https://github.com/user-attachments/assets/086afa4c-eb1f-45de-84cf-2d8551edfb74