edgartools
Advanced tools
The only SEC EDGAR library built from the ground up for AI agents and LLMs. Extract financial data in 3 lines of code instead of 100+. Production-ready MCP server included.
Built with AI-assisted development • 3-10x faster velocity • Support this project
EdgarTools is the fastest, most powerful open-source library for SEC EDGAR data extraction. Built for financial analysts, data scientists, and AI developers who need reliable, production-ready access to SEC filings.
 Lightning Fast 10-30x faster than alternatives Optimized with lxml & PyArrow |
 AI Native Built-in MCP server for Claude LLM-optimized text extraction |
 Production Quality 1000+ tests, type hints Battle-tested by analysts |
 XBRL Native Full XBRL standardization Cross-company comparisons |
 Rich Data Objects Smart parsing for every form Pandas-ready DataFrames |
 Open Source MIT license, community-driven Transparent & auditable |
# 1. Install
pip install edgartools
# 2. Set your identity (required by SEC regulations)
from edgar import *
set_identity("your.name@example.com")
# 3. Get company financials in 1 line
balance_sheet = Company("AAPL").get_financials().balance_sheet()
# 4. Explore with interactive documentation
company = Company("MSFT")
# 5. Or explore insider transactions
filings = company.get_filings(form="4")
form4_filing = filings[0]
form4 = form4_filing.obj()
|
Financial Statements (XBRL)
Fund Holdings (13F)
Company Dataset & Reference Data
Insider Transactions
|
Filing Intelligence
Performance & Reliability
Developer Experience
|
| Feature | EdgarTools | sec-api (paid) | OpenEDGAR | Manual Scraping |
|---|---|---|---|---|
| AI/MCP Integration |  |  | | |
| Cost | Free | $150+/mo | Free | Free |
| Speed | 10-30x baseline | Fast (API) | Slow | Slow |
| XBRL Support | Full |  Partial | | |
| Financial Statements | Parsed | Parsed | Basic | DIY |
| LLM-Ready Output | | | | |
| Type Hints | | | | |
| Rate Limiting | Auto | N/A (API) | Manual | Manual |
| Open Source | MIT | Proprietary | Apache | N/A |
EdgarTools provides AI Skills that enable Claude and other AI assistants to perform sophisticated SEC filing analysis. Once configured, you can ask Claude questions like:
Claude will write the Python code, execute it, and explain the results - all powered by EdgarTools.
Install the EdgarTools skill for Claude Code or Claude Desktop:
pip install "edgartools[ai]"
python -c "from edgar.ai import install_skill; install_skill()"
This adds SEC analysis capabilities to Claude, including 3,450+ lines of API documentation, code examples, and form type reference.
Run EdgarTools as an MCP server for Claude Code or Claude Desktop:
pip install "edgartools[ai]"
python -m edgar.ai
Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"edgartools": {
"command": "python",
"args": ["-m", "edgar.ai"],
"env": {
"EDGAR_IDENTITY": "Your Name your.email@example.com"
}
}
}
}
See AI Integration Guide for complete documentation.
Support AI Powered DevelopmentI build and maintain EdgarTools solo using AI-assisted development. Your support directly funds the Claude Max subscription that makes this extraordinary velocity possible.
 You Support Buy Me A Coffee contributions fund Claude Max |
 AI Acceleration Specialized agents deliver 3-10x faster development |
 Rapid Delivery Features in days instead of weeks 24 releases / 60 days |
 You Benefit More features, faster fixes, free forever |
 24Releases1 every 2.5 days |
 322Commits5.4 per day |
 3-10xVelocityvs traditional dev |
 DaysNot Weeksfor major features |
| Feature | Traditional Estimate | With AI | Speedup |
|---|---|---|---|
| XBRL Period Selection | 3-4 weeks | 5 days | 7x faster |
| MCP Workflow Tools | 2-3 weeks | 2 days | 10x faster |
| HTML Parsing Rewrite | 2 weeks | 3 days | 4x faster |
| Standardized Concepts API | 2 weeks | 2-3 days | 5x faster |
What your support enables:
Claude Max subscription (AI agents that write, test, and document code) Continued 3-10x development velocity (features in days, not weeks) Rapid response to SEC format changes and bug reports New features based on community needs Free access for everyone, forever (no API keys, no rate limits)Alternative ways to support:
Star the repo on GitHub
Report bugs and contribute fixes
Improve documentation
Answer questions in Discussions
Share EdgarTools with colleaguesCorporate users: If your organization depends on EdgarTools for SEC compliance or regulatory reporting, GitHub Sponsors offers strategic sponsorship options designed for mission-critical dependencies.
We welcome contributions from the community! Here's how you can help:
See our Contributing Guide for details.
EdgarTools is distributed under the MIT License
FAQs
Navigate Edgar filings with ease
We found that edgartools demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Socket CEO Feross Aboukhadijeh joins Insecure Agents to discuss CVE remediation and why supply chain attacks require a different security approach.
Security News
Tailwind Labs laid off 75% of its engineering team after revenue dropped 80%, as LLMs redirect traffic away from documentation where developers discover paid products.
Security News
The planned feature introduces a review step before releases go live, following the Shai-Hulud attacks and a rocky migration off classic tokens that disrupted maintainer workflows.