Skip to main content

Minut MCP Server

The Minut MCP server lets AI assistants (Claude, IDEs, and any other Model Context Protocol client) securely read data from your Minut account. Once connected, the assistant can answer questions about your devices, homes, organizations, guests, and event history.

It is a remote server, so there's nothing to download or run locally. You point your client at the server URL and sign in with your Minut account.

Server URL: https://mcp.minut.com/mcp

Prerequisites​

  • A Minut account. Sign up here if you don't have one.
  • An MCP client that supports remote servers with OAuth (for example Claude, Cursor, or VS Code).

Installing​

The server uses OAuth 2.1 (PKCE), so installation is the same everywhere: add the URL, then a browser window opens for you to sign in to Minut and approve the connection. After approval the client can call the server's tools on your behalf.

Claude (Desktop and Web)​

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Enter a name (e.g. Minut) and the URL https://mcp.minut.com/mcp.
  4. Save, then click Connect and sign in to Minut when prompted.

Claude Code​

claude mcp add --transport http minut https://mcp.minut.com/mcp

Then run /mcp inside Claude Code and follow the sign-in prompt.

Cursor / VS Code​

Add the server to your MCP config (.cursor/mcp.json in Cursor, or .vscode/mcp.json in VS Code):

{
  "mcpServers": {
    "minut": {
      "url": "https://mcp.minut.com/mcp"
    }
  }
}

Reload the client and complete the browser sign-in when prompted.

Verifying the connection​

Once connected, ask your assistant something like:

  • "Which of my devices went offline in the past 24 hours?"
  • "Summarise noise events at my apartment last weekend."
  • "Show the temperature trend for the living-room sensor over the last week."

The assistant picks the right tools automatically based on your question.

Good to know​

  • Read-only. The server does not expose any tools that create, modify, or delete data.
  • No data stored. Every request is forwarded to the Minut API with your access token, which the API validates on each call. Nothing is cached on the server.
  • Your permissions apply. Only data you have access to in Minut is returned.

Support​

If something isn't working, contact the Minut team through your usual support channel and mention that you were using the MCP server.