Oura MCP
The Oura v2 API as an MCP server. Paginates, fixes the date range, warns when data is…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 5 days ago
About Oura MCP
Oura MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
The Oura v2 API as an MCP server. Paginates, fixes the date range, warns when data is missing.
Install
Run in a terminal
claude mcp add oura-mcp --env OURA_CLIENT_SECRET='<OURA_CLIENT_SECRET>' --env OURA_PAT='<OURA_PAT>' -- uvx mcp-ouraAdd to claude_desktop_config.json
{
"mcpServers": {
"oura-mcp": {
"command": "uvx",
"args": [
"mcp-oura"
],
"env": {
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_PAT": "<OURA_PAT>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"oura-mcp": {
"command": "uvx",
"args": [
"mcp-oura"
],
"env": {
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_PAT": "<OURA_PAT>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"oura-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-oura"
],
"env": {
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_PAT": "<OURA_PAT>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"oura-mcp": {
"command": "uvx",
"args": [
"mcp-oura"
],
"env": {
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_PAT": "<OURA_PAT>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"oura-mcp": {
"command": "uvx",
"args": [
"mcp-oura"
],
"env": {
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_PAT": "<OURA_PAT>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
OURA_SANDBOXSet to 1 to use Oura's official synthetic data with no credentials. The recommended way to try the server before authenticating.OURA_CLIENT_IDclient_id of your Oura application, for OAuth2. Register one at https://cloud.ouraring.com/oauth/applications with the redirect http://localhost:9876/callback/ (the trailing slash is required).OURA_CLIENT_SECRETclient_secret of your Oura application. Only needed when running `oura-mcp --authorize` and when refreshing the token.OURA_CREDENTIALSWhere the OAuth2 credentials file lives. Defaults to ~/.config/oura-mcp/credentials.json, mode 600.OURA_PATOura Personal Access Token. Only if you already had one: Oura stopped issuing them in December 2025.OURA_PAT_FILEPath to a file holding the personal token. Preferable to OURA_PAT: an MCP server is registered in a JSON that gets backed up and shared when asking for help; a separate file rotates without touching the config.
Pricing
Open source
Oura MCP FAQ
Is Oura MCP free?
Yes. Oura MCP is open source, so you can use and self-host it for free.
How do I add Oura MCP to Claude Code?
Run this command in your terminal: claude mcp add oura-mcp --env OURA_CLIENT_SECRET='<OURA_CLIENT_SECRET>' --env OURA_PAT='<OURA_PAT>' -- uvx mcp-oura
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.