OpenAlex
OpenAlex is an open catalog of scholarly works, authors, institutions, sources, topics, and related research metadata.
Verdict
Common use cases
- Build annotated bibliographies for grant proposals
- Track citation counts for competitor research
- Find co-author networks across institutions
- Curate reading lists in private collections
- Export structured metadata for meta-analyses
Integration
- Vendor
- OpenAlex
- Category
- other
- Auth
- API_KEY
- Tools
- 14
- Composio slug
openalex
Tools
- Add Collection Entities
Bulk-add one or more matching OpenAlex entity IDs to an owned collection without duplicating existing memberships.
- Autocomplete Entities
Resolve a partial name or title to likely OpenAlex entity IDs before filtering or retrieving metadata.
- Create Collection
Create a private, single-entity-type OpenAlex collection, optionally with an initial bounded set of entity IDs.
- Delete Collectiondestructive
Permanently delete exactly one owned private OpenAlex collection and all of its collection memberships. This does not delete the underlying OpenAlex entities.
- Download Work Content
Download an OpenAlex-cached PDF or gzipped GROBID TEI file for a work. Choose the format matching the work's has_content flags. Each call currently costs $0.01, and source copyright terms still apply.
- Get Collection
Get metadata for one private OpenAlex collection owned by the connected user.
- Get Metadata Entity
Retrieve one OpenAlex work, author, source, institution, topic, keyword, publisher, funder, award, taxonomy item, country, continent, or language by its supported identifier. Returns the provider's entity object directly; use select to limi
- Get Rate Limit Status
Validate the connected OpenAlex API key and inspect daily budget, prepaid balance, reset timing, and current endpoint costs before expensive queries or downloads.
- List Collection Entities
List one page of entity IDs in an owned private collection together with collection metadata and page totals.
- List My Collections
List private OpenAlex collections owned by the connected API-key user, optionally finding collections that contain an entity.
- Query Metadata Entities
Search, filter, sort, sample, select, or group one OpenAlex metadata resource other than works, including authors, venues, organizations, taxonomy, geography, awards, and enumerations. Returns one cursor-controlled page.
- Query Works
Search, filter, sort, sample, select, or group scholarly works. Returns one cursor-controlled page and its OpenAlex query cost; use the snapshot for whole-catalog exports.
- Remove Collection Entitiesdestructive
Bulk-remove one or more entity memberships from an owned private OpenAlex collection without deleting the underlying OpenAlex entities.
- Update Collection
Update a private collection's name or description, or change its entity type while the collection is empty. Provide at least one of display_name, description, or entity_type.
Setup
Setup guide
- 1Click Integrations in your Switchy workspace sidebar, find OpenAlex under Research & Data, then click Connect. You'll be prompted to paste an API key — get yours free at openalex.org/account after signing up with email. Copy the key and paste it into Switchy's auth dialog. Grant read and collection-management scopes when prompted. Click Test Connection to verify your daily rate limit and prepaid balance appear. Open any Project, type '@OpenAlex' in the chat, and ask it to autocomplete a paper title or search for works on a topic. If metadata returns in seconds, the connection works. To download a PDF, first retrieve a work's metadata to confirm has_content flags are true, then call the download tool with the work ID and your preferred format.
What teammates see: by default, memories from OpenAlex are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Find Recent Climate Papers
@OpenAlex search for works about climate adaptation published after 2022, sort by cited_by_count descending, return the top 10 with titles and DOIs
Autocomplete Paper Title
@OpenAlex autocomplete the title 'attention is all you' and return the top 3 matching work IDs with their full titles and publication years
Create Reading List Collection
@OpenAlex create a collection named 'Transformer Architecture Papers' for works, then add the entity IDs for the top 5 most-cited papers on transformer models published since 2017
Download Paper PDF
@OpenAlex get metadata for work W2964141474 to check has_content flags, then download the PDF if available and confirm the file size
Check Rate Limit Budget
@OpenAlex get my current rate limit status including daily budget remaining, prepaid balance, and per-endpoint costs
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@OpenAlex search for recent papers on transformer architectures in natural language processing and show me the top 5 by citation count
Here are the top 5 papers on transformer architectures in NLP by citation count: 1. "Attention Is All You Need" (Vaswani et al., 2017) – 89,432 citations 2. "BERT: Pre-training of Deep Bidirectional Transformers" (Devlin et al., 2019) – 67,821 citations 3. "Language Models are Few-Shot Learners" (Brown et al., 2020) – 34,567 citations 4. "Improving Language Understanding by Generative Pre-Training" (Radford et al., 2018) – 28,943 citations 5. "XLNet: Generalized Autoregressive Pretraining" (Yang et al., 2019) – 19,234 citations Each entry includes DOI, abstract, author affiliations, and open-access status. This is an illustrative example; actual results depend on OpenAlex's current index.
This example demonstrates OpenAlex's core strength: comprehensive academic metadata search across 250M+ works. The autocomplete and metadata retrieval tools work together to resolve queries and return structured bibliographic data. No special auth scopes required beyond a valid API key, but complex queries count against your daily rate limit.
@OpenAlex create a collection called 'Q1 Literature Review' and add these five papers to it so I can track them for my research project
Collection 'Q1 Literature Review' created successfully (ID: col_abc123xyz). All 5 works have been added: - W2964141474: "Attention Is All You Need" - W2807374136: "BERT: Pre-training..." - W3037662171: "Language Models are Few-Shot..." - W2809633644: "Improving Language Understanding..." - W2963436189: "XLNet: Generalized Autoregressive..." You can retrieve this collection anytime using its ID. This is an illustrative example showing how the create and bulk-add tools coordinate to organize research materials.
This showcases OpenAlex's collection management for organizing research. Collections are private to your account and persist across sessions. Important: collections are single-entity-type only (works, authors, etc. cannot mix), and deleting a collection does not affect the underlying OpenAlex entities. Useful for literature reviews, grant proposals, or collaborative research tracking.
@OpenAlex check my rate limit status, then download the full-text PDF for the Attention Is All You Need paper if I have budget remaining
Rate limit check: You have 847 queries remaining today (resets in 14 hours). Prepaid balance: $12.40. PDF download cost: $0.01. Downloading PDF for W2964141474 ("Attention Is All You Need")... Complete. The 15-page PDF has been retrieved from OpenAlex's cache. Note: This is an illustrative example. Actual downloads depend on whether OpenAlex has cached content for the work (check has_content flags first), and you must comply with the original publisher's copyright terms even though OpenAlex hosts the file.
This example highlights two critical tools: rate-limit inspection before expensive operations, and content download for works with cached PDFs or GROBID XML. Each download costs $0.01 from your prepaid balance, so always check budget first. Not all works have downloadable content—verify has_content flags in the metadata before attempting. Downloaded files remain subject to original copyright restrictions.
Use-case deep-dives
When OpenAlex beats manual citation chasing for small research teams
A three-person academic lab writing an NIH R01 needs 40-60 recent papers on CRISPR delivery mechanisms, filtered by citation count and open-access status. OpenAlex's autocomplete and metadata tools let you build that list in under an hour without touching PubMed's clunky interface or paying Scopus fees. The collection tools keep your shortlist in one place while you draft the background section. The catch: if you need full-text analysis of paywalled papers, OpenAlex only caches open-access PDFs—you'll still hit institutional login walls for half your sources. For teams writing one or two grants a year, the API key is free and the workflow is faster than spreadsheet hell.
Track competitor publications without a $15k Scopus contract
A six-person biotech startup monitors 12 competitor labs by author and institution, pulling new publications weekly to spot IP risks or partnership signals. OpenAlex's author and institution metadata tools make this a 20-minute Slack standup ritual instead of a half-day manual search. You create one collection per competitor, add entities as they publish, and export the list to your CTO. The rate limit status tool matters here—if you're downloading dozens of PDFs for patent prior-art searches, the $0.01-per-download fee adds up fast. For monitoring and triage, OpenAlex is the right call. For deep patent work, you still need a real IP database.
When OpenAlex works for episode prep but not live fact-checking
A two-person science podcast team preps episodes on topics like microplastics or fusion energy by pulling 15-20 landmark papers, checking author affiliations, and verifying funding sources. OpenAlex's metadata retrieval and funder tools give you that context in minutes, and the autocomplete helps when a guest mentions a paper title mid-interview. The workflow breaks if you need real-time lookups during recording—API calls take 2-4 seconds, and the interface isn't built for live search. Use OpenAlex in the research phase, then screenshot or print the key facts. For a weekly show, the free tier covers your volume and the metadata depth beats Google Scholar.
Frequently asked
What does the OpenAlex MCP do in Switchy?
It connects your team to OpenAlex's academic metadata database — 250M+ research papers, authors, institutions, and citations. You can search works by title or DOI, pull author profiles, create private collections of papers, and download cached PDFs when available. Useful for literature reviews, citation analysis, or building research datasets without scraping publisher sites.
Do I need a paid OpenAlex API key to use this MCP?
Yes. OpenAlex requires an API key for all MCP operations. The free tier gives you rate limits; paid tiers unlock higher quotas and PDF downloads (currently $0.01 per file). You can check your daily budget and prepaid balance directly through the Get Rate Limit Status tool before running expensive queries.
Can the OpenAlex MCP download full-text PDFs of papers?
Only when OpenAlex has cached a PDF for that work. Use the Download Work Content tool after checking the work's has_content flags. Each download costs $0.01 against your OpenAlex prepaid balance, and the original publisher's copyright terms still apply — this isn't a paywall bypass, just a convenience cache.
How is this different from searching Google Scholar or PubMed directly?
OpenAlex gives you structured JSON metadata and bulk operations — create collections of 500 papers, autocomplete author names, filter by institution or funder — instead of clicking through paginated web results. It's faster for programmatic workflows like citation mapping or tracking an author's output, but won't replace reading the actual papers.
Who on the team should connect the OpenAlex MCP?
Whoever holds the OpenAlex API key and understands your research scope. Collections are private to the connected user, so if multiple people need access to the same paper sets, either share one Switchy workspace or coordinate collection exports. The MCP doesn't sync collections across team members automatically.