Skip to content

README.md

Latest commit

 

History

History
97 lines (67 loc) · 2.12 KB

README.md

File metadata and controls

97 lines (67 loc) · 2.12 KB

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.