Skip to main content
Glama

Personal Assistant MCP Server

by lemannrus

Nexus MCP

Features

  • Google Calendar Integration
    • Create, read, update, and delete calendar events
    • List upcoming events
  • Obsidian Vault Management
    • Create, read, update, and delete notes
    • Full-text search in notes
    • Folder management (create, delete, search, list)
  • Trello Integration
    • Board, list, and card management
    • Create, update, and delete cards
    • Search cards by text query
  • Web Page Parsing
    • Extract and clean HTML content from any URL
  • Google News Search
    • Search for recent news articles on a given topic

Join me in Telegram and Blog

Prerequisites

  • Python 3.10 or higher
  • Poetry (Python package manager)
  • Google Calendar API credentials
  • Trello API credentials (if using Trello features)
  • Obsidian Vault (if using Obsidian features)

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/nexus-mcp.git cd nexus-mcp
  2. Install dependencies using Poetry:
    poetry install
  3. Set up Google Calendar API:
    • Go to the Google Cloud Console
    • Create a new project or select an existing one
    • Enable the Google Calendar API
    • Create OAuth 2.0 credentials
    • Download the credentials and save them as credentials.json in the project root
  4. Set up Trello API (optional):

Configuration

  1. Run the initial setup to authenticate with Google Calendar:
    poetry run python main.py
    • This will open a browser window for Google authentication
    • Follow the prompts to authorize the application

Usage

  1. Start the server:
    poetry run python main.py
  2. The server will start and be ready to accept MCP-compatible client connections.
  3. Use any MCP-compatible client to interact with the server. The server provides the following tools:
    • Calendar management
    • Obsidian vault operations
    • Trello board management
    • Web page parsing

Anthropic Claude Desktop Configuration

To use this server with Anthropic Claude Desktop, add the following configuration to your Claude Desktop settings:

{ "mcpServers": { "personal-assistant": { "command": "/path/to/your/venv/bin/python", "args": ["/path/to/your/project/main.py"], "env": { "GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json", "GOOGLE_TOKEN_PATH": "/path/to/your/token.json", "GOOGLE_API_KEY": "your_google_api_key", "GOOGLE_CX_ID": "your_google_cx_id", "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault", "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder", "TRELLO_API_KEY": "your_trello_api_key", "TRELLO_TOKEN": "your_trello_token", "LOG_PATH": "/path/to/log.txt", "ENABLE_OBSIDIAN_TOOLS": "True/False", "ENABLE_TRELLO_TOOLS": "True/False", "ENABLE_CALENDAR_TOOLS": "True/False", "ENABLE_NEWS_SEARCH": "True/False", "ENABLE_WEB_PARSER": "True/False", "SEMANTIC_SEARCH_ENABLED": "True/False", "EMBEDDINGS_PATH": "/path/to/embeddings.json" } } } }

Replace the paths and credentials with your actual values:

  • command: Path to your Python virtual environment's Python executable
  • args: Path to your project's main.py file
  • ENABLE_OBSIDIAN_TOOLS: Set to True to enable Obsidian tools
  • ENABLE_TRELLO_TOOLS: Set to True to enable Trello tools
  • ENABLE_CALENDAR_TOOLS: Set to True to enable Google Calendar tools
  • ENABLE_NEWS_SEARCH: Set to True to enable Google News search
  • ENABLE_WEB_PARSER: Set to True to enable the web parser tool
  • GOOGLE_CREDENTIALS_PATH: Path to your Google Calendar credentials file (credentials.json)
  • GOOGLE_TOKEN_PATH: Path to your Google Calendar token file (token.json)
  • GOOGLE_API_KEY: Your Google API Key (for Custom Search API)
  • GOOGLE_CX_ID: Your Google Programmable Search Engine ID (CX ID for Custom Search API)
  • OBSIDIAN_VAULT_PATH: Path to your Obsidian vault
  • OBSIDIAN_DEFAULT_FOLDER: Optional path to default folder in your vault where new notes will be created
  • TRELLO_API_KEY: Your Trello API key
  • TRELLO_TOKEN: Your Trello API token
  • LOG_PATH: Path to the log file
  • SEMANTIC_SEARCH_ENABLED: Set to True to enable semantic search for Obsidian Vault
  • SIMILARITY_TRESHOLD: Default value is 0.5, this is the treshold for the semantic search
  • EMBEDDINGS_PATH: Optional path to the embeddings json file generated by the Obsidian Vector Search plugin (defaults to .obsidian/plugins/vector-search/data.json relative to OBSIDIAN_VAULT_PATH if not set)
  • MODEL_TOKEN_LIMIT: Limit for the AI model to understand when to chunk the notes
  • CHUNK_SIZE_TOKENS: Chunk size

To enable semantic search capabilities, you'll need to install the Vector Search plugin for Obsidian.

img.png

After the reindexing process is complete, the plugin will generate a JSON file containing vector embeddings at the following location:

.obsidian/plugins/vector-search/data.json

This file will be used as the embedding source for semantic search queries.

Development

  • The project uses Poetry for dependency management
  • All tools are registered in main.py
  • Service-specific implementations are in the services/ directory
  • Follow PEP 8 style guidelines for Python code

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request
-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Единый интерфейс для управления цифровой жизнью посредством интеграции с Google Calendar, Obsidian Vault, Trello и возможностями анализа веб-страниц.

  1. Функции
    1. Предпосылки
      1. Установка
        1. Конфигурация
          1. Использование
            1. Конфигурация рабочего стола Anthropic Claude
              1. Рекомендованные клиенты:
                1. Разработка
                  1. Внося вклад

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
                      Last updated -
                      4
                      2
                      TypeScript
                      MIT License
                    • VeyraXofficial

                      A
                      security
                      F
                      license
                      A
                      quality
                      Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
                      Last updated -
                      3
                      40
                      TypeScript
                    • -
                      security
                      A
                      license
                      -
                      quality
                      Integration server that enables interaction with Google services including Gmail and Calendar, allowing users to manage emails, draft responses, and schedule events across multiple Google accounts.
                      Last updated -
                      3
                      Python
                      MIT License
                      • Apple
                    • A
                      security
                      F
                      license
                      A
                      quality
                      Interact with Routine (https://routine.co/): manage calendars, tasks, notes, etc.
                      Last updated -
                      18
                      4
                      2
                      TypeScript

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/lemannrus/personal-assistant-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server