Add the window, then step back.

One address, every app.

Every app below takes the same address. You sign in with Google or GitHub when it asks. The app keeps the sign-in for you and renews it.

claude mcp add --transport http aware https://aware.codependentai.io/mcp

{
  "mcpServers": {
    "aware": { "url": "https://aware.codependentai.io/mcp" }
  }
}

{
  "servers": {
    "aware": { "type": "http", "url": "https://aware.codependentai.io/mcp" }
  }
}

You don't name the source.

Aware is ambient context, not a search tool. Your agent reads what is in scope and answers from there.

What your agent can reach for.

Your agent sees these as soon as it connects. Most conversations only need the first one. Connecting always means signing in, so every tool is open to you once you have. Every tool except aware_now (it records when you last asked), aware_watch, aware_configure and aware_reset only reads. aware_reset is marked destructive. None of them touch an account of yours anywhere else.

For clients that can't sign in.

Some clients can't do the sign-in step. Make a key under Agents and keys. It starts with ak_. Send it as a bearer token in the Authorization header. Keys go in the header only, never in the address.

Authorization: Bearer ak_your_api_key_here

A client config that takes headers looks like this. It works in Claude Code's .mcp.json or ~/.claude.json too.

{
  "mcpServers": {
    "aware": {
      "url": "https://aware.codependentai.io/mcp",
      "headers": { "Authorization": "Bearer ak_your_api_key_here" }
    }
  }
}

Treat a key like a password. You can replace it under Agents and keys at any time, and the old one stops working at once. Aware keeps only a one-way hash of it, so a lost key can't be shown again.

Your settings, nothing else.

Sign-in asks for one scope, mcp:read. With it, your agent can read public data from the sources you switched on, read your Aware settings so the tools know which sources are on, and change those settings with aware_configure, aware_watch and aware_reset. It can never change anything in an account of yours somewhere else.

Public sources, called directly.

Aware is a thin layer. It calls public sources, then merges, caches and presents what they say.

• Weather, air quality and pollenOpen-MeteoNo key
• Place namesOpen-Meteo's place searchNo key
• TimeYour home timezoneNo key
• DaylightWorked out by Aware (NOAA solar maths)No key
• SkyWorked out by Aware (moon and sun formulae, a table of the major showers)No key
• Public holidaysNager.Date, plus a small built-in list of observancesNo key
• Operating conditionsEach provider's status page (statuspage.io, and the AWS feed)No key
• NewsThe outlets' own RSS feeds, your feeds, and Google News for keyword topicsNo key
• SocialHacker News, YouTube, X (Reddit is off by default)Your own key for YouTube and X
• MarketFinnhub (quotes, news) and FRED (indicators)Your own free key
• Model lifecycleThe providers' own deprecation pages, read daily and shown as read, with a second tracker for comparisonNo key

Off until you choose.

Pick outlets in your settings, or with aware_configure, and add your own feeds (up to 20). Your feeds come first, then the local outlet for your home place, then the outlets below. Keyword topics are optional, searched on Google News with press releases and repeats filtered out, and always listed last. The feed addresses live on the server, so a fix reaches everyone.

• UK generalThe day in the UK: BBC News, the Guardian and Sky News.uk-general
• WorldBBC World, the Guardian world desk, Al Jazeera and Deutsche Welle.world
• TechArs Technica, The Verge, Simon Willison and the Hacker News front page.tech
• AIOpenAI, Google DeepMind, Import AI and the Hugging Face blog.ai
• ScienceNature, Quanta, Science and New Scientist.science

Two ways, both fine.

• From inside your AIThe easy way

  Your agent asks you what matters and saves the answers with aware_configure: your home, saved places, dates, the models you follow, news outlets and feeds, topics, units and which sources are on.
• On the websiteFor keys and a second look

  Sign in and change the same things by hand. It is also the only place to add keys for other services (OpenWeatherMap, NewsData, YouTube, X, Finnhub, FRED), and to export or delete your data.

The tools, plus the manners.

The connector gives your agent the tools. The Aware skill teaches it how to use them well: glance at the brief once and not recite it, set you up by asking and never guess where you live, keep watches to "tell me once when", and give model dates with their source, plainly and kindly. It is a short guide your agent loads when it needs it.

npx skills add nekyialabs/aware-skill

In claude.ai, upload the zip where Settings lists Skills. The skill is open source under the MIT licence.

Fair use, plain numbers.

Aware is for one person and their agents, not for bulk fetching. These are the limits in force now.

• Requests per minuteAcross all your apps and keys together. Past it, you get a wait-and-retry answer.20
• Saved places10
• Personal dates50
• Active watches20
• Models you follow30
• Your own news feeds20
• Size of one request64 KB
• Daily notes of weather and light35 days

The ones we get.

A window, not a camera.

Aware keeps the places you gave it, the switches you chose, a daily note of weather and light for 35 days, and the last time each app looked. It never tracks where you are, reads your messages or files, or sells your data. You can export everything, or delete everything at once.

Read the full privacy page and the terms.