Skip to content

jgintert/MorgenMCP

 
 

Repository files navigation

MorgenMCP

An MCP server for the Morgen calendar API.

Requirements

Installation

No installation required! MCP clients run the server directly from GitHub.

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "morgen": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/k3KAW8Pnf7mkmdSMPHz27/MorgenMCP@main",
        "morgenmcp"
      ],
      "env": {
        "MORGEN_API_KEY": "your_api_key_here"
      }
    }
  }
}

To pin to a specific version, replace @main with a version tag (e.g., @v0.1.0).

Available Tools

  • list_calendars - List all calendars
  • update_calendar_metadata - Update calendar display name or color
  • list_events - List events with optional date filtering
  • create_event - Create a new calendar event
  • update_event - Update an existing event
  • delete_event - Delete an event

Development

# Clone the repository
git clone https://github.com/k3KAW8Pnf7mkmdSMPHz27/MorgenMCP.git
cd MorgenMCP

# Install dependencies
uv sync --all-extras

# Run tests
uv run pytest

Environment Setup

Create a .env file with your API key:

echo "MORGEN_API_KEY=your_api_key" > .env

The server loads .env automatically when running locally:

uv run morgenmcp

Local Debugging with MCP Inspector

The MCP Inspector provides a web UI for testing tools and inspecting requests/responses:

npx @modelcontextprotocol/inspector uv run morgenmcp

Opens at http://localhost:6274

Releasing

Releases are managed via git tags:

git tag -a v0.1.0 -m "Release v0.1.0"
git push origin v0.1.0

Users can then reference the specific version in their MCP client configuration.

License

Apache 2.0 - See LICENSE and NOTICE for details.

About

MCP server for Morgen calendar API - manage calendars and events via Claude Desktop

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 100.0%