hackerdogs/acuvity-mcp-server-microsoft-graph-mcp repository overview

⁠

⁠Acuvity Server Microsoft Graph MCP Server

MCP server wrapper for Microsoft Graph MCP Server⁠ — access Microsoft 365 data including users, applications, mail, calendar, and Teams via the Microsoft Graph API.

⁠What is Acuvity Server Microsoft Graph?

Microsoft Graph MCP Server connects AI assistants to the Microsoft Graph API, enabling queries against Azure AD applications, users, groups, mailboxes, calendar events, Teams messages, and SharePoint resources. It uses OAuth 2.0 client credentials flow to authenticate against a registered Azure AD app. See microsoftgraph/msgraph-mcp⁠ for full documentation.

API credentials required — set AZURE_TENANT_ID, AZURE_CLIENT_ID, and AZURE_CLIENT_SECRET for your registered Azure AD application with the required Microsoft Graph API permissions.

Tools:

• acuvity_mcp_server_microsoft_graph_info — Return basic info / status for Microsoft Graph MCP Server.

⁠Tools Reference

⁠Example Prompts

Here are example prompts you can use with Claude (or any MCP client) when this tool is connected:

• "List all Azure AD applications in my tenant and show their display names and app IDs."
• "Use Microsoft Graph to find all users in my tenant who have not signed in for 90 days."
• "Get the members of the 'Security Team' Azure AD group via Microsoft Graph."
• "List all service principals with owner permissions assigned in my Azure AD tenant."
• "Use Microsoft Graph to retrieve the last 10 sign-in log entries for [email protected]⁠."
• "Show all OAuth2 permission grants assigned to applications in my Azure AD tenant."

⁠Deploy

⁠Docker Compose (recommended)

docker-compose up -d

⁠Docker Run (stdio mode)

docker run -i --rm hackerdogs/acuvity-mcp-server-microsoft-graph-mcp:latest

⁠Docker Run (HTTP streamable mode)

docker run -d -p 8433:8433 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8433 \
  hackerdogs/acuvity-mcp-server-microsoft-graph-mcp:latest

⁠MCP Client Configuration

⁠Stdio mode (default)

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "acuvity-mcp-server-microsoft-graph-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT", "hackerdogs/acuvity-mcp-server-microsoft-graph-mcp:latest"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

⁠HTTP mode (streamable-http)

First, start the server using Docker Compose or docker run with HTTP mode (see Deploy⁠ above), then point your MCP client at the running server:

{
  "mcpServers": {
    "acuvity-mcp-server-microsoft-graph-mcp": {
      "url": "http://localhost:8433/mcp"
    }
  }
}

⁠Environment Variables

⁠Installing in Hackerdogs

The fastest way to get started is through Hackerdogs⁠:

1. Log in to your Hackerdogs account.
2. Go to the Tools Catalog.
3. Search for the tool by name (e.g. "nuclei", "naabu", "julius").
4. Expand the tool card and click Install — you're ready to go.

1. Vendor API key required? Add your key in the config environment variable field before clicking Install. Your key will be encrypted at rest.
2. Enable / Disable the tool anytime from the Enabled Tools page.
3. Need to update a key or parameter? Go to My Tools → toggle Show Decrypted Values → edit → Save.

⁠Build

docker build -t hackerdogs/acuvity-mcp-server-microsoft-graph-mcp:latest .

⁠Testing

⁠Automated tests

./test.sh

⁠Test directly with Docker

1. Start the server in HTTP mode:

docker run -d --rm --name acuvity-mcp-server-microsoft-graph-mcp-test -p 8433:8433 \
  -e MCP_TRANSPORT=streamable-http \
  hackerdogs/acuvity-mcp-server-microsoft-graph-mcp:latest

2. Initialize the MCP session:

SESSION_ID=$(curl -s -D - -X POST http://localhost:8433/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST http://localhost:8433/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. Call a tool:

curl -s -X POST http://localhost:8433/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"run_acuvity_server_microsoft_graph","arguments":{"arguments":"--help"}}}'

4. Clean up:

docker stop acuvity-mcp-server-microsoft-graph-mcp-test

⁠Running the tool directly (bypassing MCP)

You can run the Acuvity Server Microsoft Graph CLI in the same container by overriding the entrypoint without starting the MCP server.

Show help:

docker run -i --rm --entrypoint acuvity-server-microsoft-graph hackerdogs/acuvity-mcp-server-microsoft-graph-mcp:latest --help