Oura MCP Server
A Model Context Protocol (MCP) server that provides access to the Oura API. It allows language models to query sleep, readiness, and resilience data from Oura API.
Available Tools
The server exposes the following tools:
Date Range Queries
get_sleep_data(start_date: str, end_date: str): Get sleep data for a specific date rangeget_readiness_data(start_date: str, end_date: str): Get readiness data for a specific date rangeget_resilience_data(start_date: str, end_date: str): Get resilience data for a specific date range
Dates should be provided in ISO format (YYYY-MM-DD).
Today's Data Queries
get_today_sleep_data(): Get sleep data for todayget_today_readiness_data(): Get readiness data for todayget_today_resilience_data(): Get resilience data for today
Usage
You'll need an Oura API token to use this server. You can obtain one by:
- Going to the Oura Developer Portal
- Creating a Personal Access Token
Claude for Desktop
Update 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:
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": [
"oura-mcp-server"
],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}
Example Queries
Once connected, you can ask Claude questions like:
- "What's my sleep score for today?"
- "Show me my readiness data for the past week"
- "How was my sleep from January 1st to January 7th?"
- "What's my resilience score today?"
Error Handling
The server provides human-readable error messages for common issues:
- Invalid date formats
- API authentication errors
- Network connectivity problems
License
This project is licensed under the MIT License - see the LICENSE file for details.
Metadata
Release files for oura-mcp-server 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| oura_mcp_server-0.1.3.tar.gz | 5.5 kB | Without provenance | Details for oura_mcp_server-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| oura_mcp_server-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for oura_mcp_server-0.1.3-py3-none-any.whl |
Total release size: 12.0 kB
Release files / oura_mcp_server-0.1.3.tar.gz
| Download URL | oura_mcp_server-0.1.3.tar.gz |
|---|---|
| Size | 5.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae4a6d4a8bb4d82afd8ea55c59b9aeec5fff90f21c769db29b8a07dede400186
|
|
BLAKE2b-256 checksum How to use checksums |
adaf4bb8c1feaeab3040e468b7b8fc2b60977a61cee9e2713098ff8a1748016d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.0
|
Release files / oura_mcp_server-0.1.3-py3-none-any.whl
| Download URL | oura_mcp_server-0.1.3-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f5434d34881ef468ae5bb57fe168ee2fa1e1c87a819f87c269f33789eccbb44d
|
|
BLAKE2b-256 checksum How to use checksums |
554f5375e1de6df34326b0bd8de9d2a81c2a7c3243aa8356a0e6b2eaa90bf040
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.0
|
Security for oura-mcp-server 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.