You can run MIST, an MCP server that lets AI assistants interact with notes, Gmail, Calendar, Tasks, and Git through a standardized protocol. With MIST, you perform actions in external services, access real-time data, and keep context across conversations, all within a single, cohesive server you control locally or on your infrastructure.

How to use

Start the MCP server from your command line and connect your MCP client to it. You will interact with MIST by sending MCP requests that perform actions such as creating notes, reading emails, managing calendar events, handling tasks, and performing Git operations. The server handles authentication with Google services and talks to the respective external APIs, returning structured results you can present to the user.

How to install

Prerequisites you need before installation:

Python 3.13 or newer
UV (recommended) or pip
Google account for Gmail/Calendar/Tasks
Git for Git integration

Install the MCP server package and dependencies using the recommended method, then set up environment configuration.

uv install

or

pip install -e .

Create a local environment file with the necessary paths for notes and Google API credentials.

# Create a .env file with your configuration
MIST_NOTES_DIR=/path/to/your/notes/directory
MIST_GOOGLE_CREDENTIALS_PATH=./credentials.json
MIST_GOOGLE_TOKEN_PATH=./token.json

Edit the values to match your environment.

## Google API configuration and first run

To enable Gmail, Calendar, and Tasks integrations, you need a Google Cloud project and OAuth credentials. Follow the steps below to obtain the credentials and run MIST for the first time.

Steps overview (do these in your browser or Google Cloud Console)

1. Create a Google Cloud Project

2. Enable Gmail API, Calendar API, and Tasks API

3. Configure OAuth consent screen

4. Create OAuth client ID (Desktop application) and download credentials.json

5. Place credentials.json in your project directory

When you start MIST for the first time, the server will guide you through the OAuth flow in your browser and store the tokens for future runs.

Available tools

note_management

Create, edit, read, search, and organize notes with persistent local storage.

gmail_integration

Search, read, compose, and send emails; manage Gmail labels and read status.

calendar_integration

Create, update, and delete calendar events; list calendars and search by date.

tasks_integration

Create and manage task lists; add, complete, and delete tasks.

git_integration

Run Git operations in local repositories, including status, diff, commit, and branch management.