@softeria/ms-365-mcp-server 0.1.11 → 0.2.2

package/README.md

@@ -7,6 +7,12 @@ A Model Context Protocol (MCP) server for interacting with Microsoft 365 service
 [![Build Status](https://github.com/softeria-eu/ms-365-mcp-server/actions/workflows/build.yml/badge.svg)](https://github.com/softeria-eu/ms-365-mcp-server/actions/workflows/build.yml)
 [![npm version](https://img.shields.io/npm/v/@softeria/ms-365-mcp-server.svg)](https://www.npmjs.com/package/@softeria/ms-365-mcp-server)
 
+## Quick Start Example
+
+Login and test authentication in Claude Desktop:
+
+![MS 365 MCP Server login example in Claude Desktop](https://github.com/user-attachments/assets/936d16bc-b3e1-437b-b3f1-03c54874a816)
+
 ## Features
 
 - Authentication using Microsoft Authentication Library (MSAL)
@@ -28,14 +34,6 @@ npx @softeria/ms-365-mcp-server
 
 ## Integration with Claude
 
-### Claude Code CLI
-
-To add this MCP server to Claude Code CLI:
-
-```bash
-claude mcp add ms -- npx @softeria/ms-365-mcp-server
-```
-
 ### Claude Desktop
 
 To add this MCP server to Claude Desktop:
@@ -48,17 +46,32 @@ To add this MCP server to Claude Desktop:
     - Command: `npx @softeria/ms-365-mcp-server`
     - Click "Add"
 
-### Direct Configuration
-
-You can also use this configuration JSON in compatible Claude interfaces:
+Alternatively, you can edit Claude Desktop's configuration file directly. The location varies by platform, but you can
+find it by going to Settings > Developer > Edit Config. Add this to your configuration file:
 
 ```json
 {
-  "name": "ms",
-  "command": "npx @softeria/ms-365-mcp-server"
+  "mcpServers": {
+    "ms": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@softeria/ms-365-mcp-server"
+      ]
+    }
+  }
 }
 ```
 
+### Using Claude Code CLI
+
+Claude Code CLI integration is available but configuration methods may vary based on the current version. Please refer
+to the [official Claude Code documentation](https://github.com/anthropics/claude-code) for the most up-to-date
+instructions on adding MCP servers.
+
+For other Claude interfaces that support MCPs, please refer to their respective documentation for the correct
+integration method.
+
 ## Development
 
 ### Setup
@@ -88,17 +101,24 @@ This repository uses GitHub Actions for continuous integration and deployment:
 To create a new release:
 
 ```bash
+# Default (patch version): 0.1.11 -> 0.1.12
 npm run release
+
+# Minor version: 0.1.11 -> 0.2.0
+npm run release minor
+
+# Major version: 0.1.11 -> 1.0.0
+npm run release major
 ```
 
 This script will:
 
 1. Run tests to verify everything works
-2. Bump the version number
+2. Bump the version number according to the specified type (patch by default)
 3. Commit the version changes
 4. Push to GitHub
 5. Create a GitHub release
-6. Trigger the publish workflow to publish to npm
+6. Trigger the publishing workflow to publish to npm
 
 ## Usage
 
@@ -160,12 +180,34 @@ Authentication tokens are cached securely in your system's credential store with
 
 ### MCP Tools
 
-This server provides several MCP tools for interacting with Excel files:
+This server provides several MCP tools for interacting with Microsoft 365 services:
+
+#### Authentication Tools
 
 - `login`: Start a new login process with Microsoft (returns login URL and code)
 - `verify-login`: Check if login was completed successfully and verify Graph API access
 - `logout`: Log out of Microsoft and clear credentials
 - `test-login`: Test current authentication status and verify Graph API access
+
+#### Files/OneDrive Tools
+
+- `list-files`: List files and folders in a specified path
+- `get-file`: Get details of a specific file
+- `create-folder`: Create a new folder
+- `delete-item`: Delete a file or folder
+- `copy-item`: Copy a file or folder to a new location
+- `move-item`: Move a file or folder to a new location
+- `rename-item`: Rename a file or folder
+- `search-files`: Search for files matching a query
+- `get-shared-items`: Get a list of items shared with you
+- `create-sharing-link`: Create a sharing link for a file or folder
+- `get-file-content`: Get the content of a file
+
+#### Excel Tools
+
+All Excel tools require a `filePath` parameter to specify which Excel file to operate on. You can use the Files tools to
+find and manage your Excel files.
+
 - `update-excel`: Update cell values in an Excel worksheet
 - `create-chart`: Create a chart in an Excel worksheet
 - `format-range`: Apply formatting to a range of cells
@@ -173,6 +215,43 @@ This server provides several MCP tools for interacting with Excel files:
 - `create-table`: Create a table from a range of cells
 - `get-range`: Get values from a range of cells
 - `list-worksheets`: List all worksheets in the workbook
-- `close-session`: Close the current Excel session
+- `close-session`: Close the session for a specific Excel file
+- `close-all-sessions`: Close all active Excel sessions
 - `delete-chart`: Delete a chart from a worksheet
 - `get-charts`: Get all charts in a worksheet
+
+Example workflow:
+
+1. Use `list-files` to find Excel files in your OneDrive
+2. Use `list-worksheets` with the file path to see available worksheets
+3. Use `get-range` to retrieve data from the Excel file
+4. Use other Excel tools to manipulate the file as needed
+
+#### Calendar Tools
+
+Tools for working with Outlook calendars.
+
+- `list-calendars`: List all calendars
+- `get-default-calendar`: Get information about the default calendar
+- `list-events`: List events from a calendar with optional filtering, sorting, and date ranges
+- `get-detailed-events`: Get events with expanded properties and options to include body, attendees, extensions, etc.
+- `get-event`: Get detailed information about a specific calendar event
+- `create-event`: Create a new calendar event with comprehensive options (sensitivity, importance, free/busy status,
+  optional attendees, reminders, online meetings, categories)
+- `create-recurring-event`: Create recurring events (daily, weekly, monthly, yearly) with the same comprehensive options
+  and flexible recurrence patterns
+- `update-event`: Update an existing calendar event
+- `delete-event`: Delete a calendar event
+- `accept-event`: Accept a calendar meeting invitation
+- `decline-event`: Decline a calendar meeting invitation
+- `tentatively-accept-event`: Tentatively accept a calendar meeting invitation
+- `find-meeting-times`: Find available meeting times for a set of attendees
+- `get-schedules`: Get availability information for multiple users or resource rooms
+
+#### Mail Tools
+
+Tools for working with Outlook email.
+
+- `list-messages`: List emails from any mail folder with powerful filtering, searching, and sorting options
+- `get-message`: Get detailed information about a specific email message with options to include attachments and other
+  metadata

package/bin/release.mjs

@@ -3,6 +3,43 @@
 import { execSync } from 'child_process';
 import fs from 'fs';
 
+try {
+  const currentBranch = execSync('git rev-parse --abbrev-ref HEAD').toString().trim();
+  if (currentBranch !== 'main') {
+    console.error(
+      `Error: You must be on the 'main' branch to create a release. Current branch: ${currentBranch}`
+    );
+    process.exit(1);
+  }
+} catch (error) {
+  console.error('Failed to determine current git branch:', error.message);
+  process.exit(1);
+}
+
+try {
+  const changes = execSync('git status --porcelain').toString();
+  if (changes.length > 0) {
+    console.error(
+      'Error: You have uncommitted changes. Please commit or stash them before creating a release.'
+    );
+    console.error(changes);
+    process.exit(1);
+  }
+} catch (error) {
+  console.error('Failed to check git status:', error.message);
+  process.exit(1);
+}
+
+const args = process.argv.slice(2);
+const releaseType = args[0] || 'patch';
+
+if (!['major', 'minor', 'patch'].includes(releaseType)) {
+  console.error('Invalid release type. Must be one of: major, minor, patch');
+  process.exit(1);
+}
+
+console.log(`Release type: ${releaseType}`);
+
 console.log('Running tests...');
 try {
   execSync('npm test', { stdio: 'inherit' });
@@ -11,8 +48,8 @@ try {
   process.exit(1);
 }
 
-console.log('Bumping version...');
-execSync('npm version --no-git-tag-version patch');
+console.log(`Bumping ${releaseType} version...`);
+execSync(`npm version --no-git-tag-version ${releaseType}`);
 
 const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
 const version = packageJson.version;