Oura MCP Server

1# Oura MCP Server
2 
3![Python Package](https://github.com/tomekkorbak/oura-mcp-server/workflows/Python%20Package/badge.svg)
4[![PyPI version](https://badge.fury.io/py/oura-mcp-server.svg)](https://badge.fury.io/py/oura-mcp-server)
5[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)
7 
8A [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides access to the Oura API. It allows language models to query sleep, readiness, and resilience data from Oura API.
9 
10## Available Tools
11 
12The server exposes the following tools:
13 
14### Date Range Queries
15 
16- `get_sleep_data(start_date: str, end_date: str)`: Get sleep data for a specific date range
17- `get_readiness_data(start_date: str, end_date: str)`: Get readiness data for a specific date range
18- `get_resilience_data(start_date: str, end_date: str)`: Get resilience data for a specific date range
19 
20Dates should be provided in ISO format (`YYYY-MM-DD`).
21 
22### Today's Data Queries
23 
24- `get_today_sleep_data()`: Get sleep data for today
25- `get_today_readiness_data()`: Get readiness data for today
26- `get_today_resilience_data()`: Get resilience data for today
27 
28## Usage
29 
30You'll need an Oura API token to use this server. You can obtain one by:
31 
321. Going to the [Oura Developer Portal](https://cloud.ouraring.com/v2/docs)
332. Creating a Personal Access Token
34 
35### Claude for Desktop
36 
37Update your `claude_desktop_config.json` (located in `~/Library/Application\ Support/Claude/claude_desktop_config.json` on macOS and `%APPDATA%/Claude/claude_desktop_config.json` on Windows) to include the following:
38 
39```json
40{
41    "mcpServers": {
42        "oura": {
43            "command": "uvx",
44            "args": [
45                "oura-mcp-server"
46            ],
47            "env": {
48                "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
49            }
50        }
51    }
52}
53```
54 
55 
56## Example Queries
57 
58Once connected, you can ask Claude questions like:
59 
60- "What's my sleep score for today?"
61- "Show me my readiness data for the past week"
62- "How was my sleep from January 1st to January 7th?"
63- "What's my resilience score today?"
64 
65## Error Handling
66 
67The server provides human-readable error messages for common issues:
68 
69- Invalid date formats
70- API authentication errors
71- Network connectivity problems
72 
73## License
74 
75This project is licensed under the MIT License - see the LICENSE file for details.
76