AUTOMATIONSWITCH
OfficialDatabase

Timescale Postgres AI Guide

by Timescale

Timescale official MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding agents write better Postgres queries. 1,718 GitHub stars and 2 commits on main in the last 30 days.

1,718·5 tools·Released OCT 2025·Apache-2.0
npx -y @timescale/pg-aiguide
Share:

Timescale official MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding agents write better Postgres queries. 1,718 stars and 2 commits on main in the last 30 days.

Reviewed by M. Nouriel · MAY 2026

INSTALL THIS SERVER

Requires authenticationPG_CONNECTION_STRING environment variable for live-database analysis. Documentation tools work without a database connection.
{ "mcpServers": { "pg-aiguide": { "command": "npx", "args": [ "-y", "@timescale/pg-aiguide" ], "env": { "PG_CONNECTION_STRING": "postgres://user:pass@host:5432/db" } } } }
PrereqNPM: `@timescale/pg-aiguide`. PG_CONNECTION_STRING enables live-database analysis; documentation tools work without it. Path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
{ "mcpServers": { "pg-aiguide": { "command": "npx", "args": [ "-y", "@timescale/pg-aiguide" ], "env": { "PG_CONNECTION_STRING": "postgres://user:pass@host:5432/db" } } } }
{ "mcpServers": { "pg-aiguide": { "command": "npx", "args": [ "-y", "@timescale/pg-aiguide" ], "env": { "PG_CONNECTION_STRING": "postgres://user:pass@host:5432/db" } } } }
{ "mcpServers": { "pg-aiguide": { "command": "npx", "args": [ "-y", "@timescale/pg-aiguide" ], "env": { "PG_CONNECTION_STRING": "postgres://user:pass@host:5432/db" } } } }
{ "mcpServers": { "pg-aiguide": { "command": "npx", "args": [ "-y", "@timescale/pg-aiguide" ], "env": { "PG_CONNECTION_STRING": "postgres://user:pass@host:5432/db" } } } }

5 TOOLS AVAILABLE

pg_explain
Explain a Postgres query plan with optimisation hints
Read
pg_skills
Retrieve curated Postgres skill documentation
Read
timescale_docs
Search TimescaleDB documentation
Read

OUR ASSESSMENT

Strengths
  • Timescale official maintenance.
  • 1,718 GitHub stars.
  • 2 commits on main in the last 30 days.
  • Apache-2.0 license.
  • Skills-and-docs scope rather than raw SQL execution.
  • Curated guidance from the Timescale team.
Weaknesses
  • Postgres/TimescaleDB-specific; non-Postgres use cases find no value.
  • Skills coverage depends on Timescale catalog updates.
  • Live-database tools require a PG_CONNECTION_STRING; doc tools alone work without a database.
Security Notes

PG_CONNECTION_STRING grants the connecting role permissions to the database. Use a read-only role for analyse/explain workloads. Documentation tools require no database connection and carry no DB-side risk.

Best For

AI coding agents writing Postgres queries who need expert-level guidance; TimescaleDB users who want their Claude/Cursor agent to ground in current Timescale docs; teams new to Postgres who want their agent to surface idioms and pitfalls.

TECHNICAL DETAILS

Language
typescript
Transport
stdio
Clients
Claude DesktopClaude CodeCursorVS CodeWindsurf
License
Apache-2.0
GitHub
npm
@timescale/pg-aiguide
Last Release
@timescale/pg-aiguide (npm latest)MAY 9, 2026
First Released
OCT 1, 2025

ADOPTION METRICS

// GitHub Stars
1,718

// Reading this1,718 stars on timescale/pg-aiguide. 2 commits on main in the last 30 days.

// Popularity Rank
#13
Globally · #13 in Database

// Reading thisPairs with postgres-mcp, mongodb-mcp, neon-mcp, supabase, planetscale-mcp, MCP Toolbox for Databases, dbhub-mcp in database. Timescale's pg-aiguide owns the Postgres-skills slot.

SOURCES & VERIFICATION

We don't take any single directory's word for it. Before scoring, we cross-reference 5 public MCP sources, install the server ourselves against the clients we cover, and record when we last re-verified.

01
Discovered
Manual submission
First indexed MAY 9, 2026
02
Cross-referenced
5 directories
PulseMCP, MCP.so, Glama, Smithery, Official MCP Registry
03
Verified against
Claude Desktop, Cursor
Installed and tested across clients
04
Last re-checked
MAY 9, 2026
Weekly re-verification
// How other directories see it

The same server, 5 different lenses. We reconcile these signals into our editorial score, which is why our number sometimes diverges from a directory-aggregate star count.

SourceTheir ratingTheir star countTheir downloadsLast synced
AutomationSwitch This page4.4editorial1,718MAY 9, 2026
PulseMCP— unratedunavailableunavailableMAY 9, 2026
MCP.so— unratedunavailableunavailableMAY 9, 2026
Glama— unratedunavailableunavailableMAY 9, 2026
Smithery— unratedunavailableunavailableMAY 9, 2026
Official MCP Registry— unratedunavailableunavailableMAY 9, 2026

// Counts are directory-reported; we don't adjust them. Discrepancies usually come from different snapshot times or star-caching.

OTHER DATABASE MCP SERVERS

Official5

Postgres MCP

Anthropic

Official MCP server for PostgreSQL. Provides read and write access to PostgreSQL databases with schema introspection, query execution, and transaction support. The reference implementation for database MCP servers.

14 tools84,955
Vendor5

Supabase

Supabase

Persistence layer with full Postgres access and Row Level Security awareness. Query tables, manage schemas, handle auth users, and work with storage buckets.

18 tools2,663
Official4.7

MCP Toolbox for Databases

Google (googleapis)

Google's open-source MCP server for databases. One MCP binary speaks PostgreSQL, MySQL, BigQuery, Spanner, AlloyDB, Cloud SQL, and SQLite. 14,937 GitHub stars and 100 commits on main in the last 30 days. Highest commit cadence in the directory.

7 tools14,937
Official4.5

ClickHouse MCP

ClickHouse

Official ClickHouse MCP server with both ClickHouse Tools (production cluster queries) and chDB Tools (embedded ClickHouse for local analytics). Apache-2.0 with destructive-operation protection: write access is opt-in via configuration.

5 tools766
Official4.4

DBHub

Bytebase

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, and SQLite. Maintained by Bytebase. 2,717 GitHub stars and 3 commits on main in the last 30 days.

6 tools2,717
Official4.4

Redis MCP

Redis

Official Redis MCP server with natural-language interface for managing and searching Redis data. EntraID authentication for Azure Managed Redis included; Redis ACL configurable via environment variables. Tool coverage spans strings, lists, hashes, sets, sorted sets, JSON, vectors, and search.

8 tools499
// Get in touch

DISCUSS YOUR
MCP REQUIREMENTS.

Evaluating a server, scoping an internal deployment, or working out whether MCP is the right fit at all. Start the conversation and we will point you at the right piece of the ecosystem.

Discuss Your MCP Requirements →